接口说明
所有文档

          百度智能门户 AIPAGE

          接口说明

          创建站点

          接口描述

          本接口用于创建 AIPAGE 站点。支持批量创建。创建接口为同步接口,调用成功后会自动下单并扣款,扣款成功后会开始创建资源,最终返回创建的所有资源详情。

          注意事项

          • 请务必在账户中提前预留足够的金额保证预付费订单的自动扣款成功,否则调用该 API 会失败并返回错误。
          • 如果在 24 小时内使用相同的参数和 clientToken,第二次则不会进行扣费购买,并返回上次订单创建的站点列表。
          • 创建前当前账户必须在 https://console.bce.baidu.com/aipage/ 下过单之后才可使用此接口,在控制台下单后表示您同意我们使用您的 ak/sk 对资源进行操作。
          • AIPAGE 的资源管理是基于百度云账户 accountId,所有子账户和主账户 accountId 相同,共享所有已创建资源的管理员。
          • 下单并创建好资源之后,当前账户(api 中使用的 ak/sk 用户)即拥有所有资源的管理员权限,后续续费/变配该资源时必须仍有该创建者操作,无法转移。
          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          POST /v{version}/site/new?clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {
              "items": [
                  {
                      "config": {
                          "comboName": "site_miniprogram_2",
                          "count": 1,
                          "name": "321",
                          "time": 1
                      },
                  }
              ]
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          items List<SiteCreateItemModel> RequestBody参数 创建的站点配置

          SiteCreateItemModel

          参数名称 类型 是否必需 参数位置 描述
          config SiteCreateItemConfigModel RequestBody参数 站点配置

          SiteCreateItemConfigModel

          参数名称 类型 是否必需 参数位置 描述
          comboName String RequestBody参数 套餐名称,具体见套餐规格,套餐名称例如 site_miniprogram_2
          name String RequestBody参数 站点名称,2-20 长度的英文数字字符,不能包含特殊字符
          count Number RequestBody参数 站点数量,数量限制为 1 - 10
          time Number RequestBody参数 购买的站点时长,数量限制为 1 - 10

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回订单 ID 及创建的资源列表详情
          success Boolean 表示当前操作是否成功

          请求示例

          POST https://aipage.baidubce.com/v1/site/new?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {
              "items": [{
                  "config": {
                      "comboName": "site_miniprogram_2", // 套餐名称,可以根据获取套餐接口获取到,这里是全网门户-展示版套餐
                      "name": "openapi_site1", // 创建的站点名称
                      "time": 2, // 创建的站点时长。单位为年,这里代表创建了一个时长为 2 年的站点。
                      "count": 1 // 创建的站点个数。这里为 1 代表创建 1 个时长两年名称为「openapi_site1」套餐规格为「全网门户-基础版」站点。
                  }
              }, {
                  "config": {
                      "comboName": "miniprogram_3", // 同上,套餐名称,这里代表是小程序门户-官网版套餐
                      "name": "openapi_site2",
                      "time": 1, // 创建的站点时长。单位为年,这里为 1 代表创建的站点时长为 1。
                      "count": 2 // 创建的站点个数。这里为 2 代表最终需要创建 2 个时长一年名称为 「openapi_site2」套餐规格为 「小程序门户-官网版」站点。
                  }
              }]
          }

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "result": {
                  "orderId": "e9134567-e838-b4c7-45e4-f6225dd26676",
                  "sites": [
                      {
                          "id": "71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",    // 站点 ID
                          "name": "openapi_site1",                         // 创建站点的名称
                          "type": 13,                                      // 标记套餐的类型,与 productSerie + productType 代表的意义相同
                          "productSerie": "site_miniprogram_",             // 产品系列,此处代表全网门户
                          "productType": "1",                              // 产品版本,此处代表基础版
                          "status": "RUNNING",                             // 站点状态
                          "createTime": "2019-04-18T08:54:16.000Z",        // 创建时间
                          "expireTime": "2021-04-18T08:54:16.000Z",        // 过期时间
                          "isOldData": false                               // 是否为试用版本站点,true 代表未付费的前期试用站点
                      },
                      {
                          "id": "835d097d-3b7e-4c01-9646-262cf75d30d6",
                          "name": "openapi_site2",
                          "type": 51,
                          "productSerie": "miniprogram_",
                          "productType": "3",
                          "status": "RUNNING",
                          "createTime": "2019-04-18T08:52:17.000Z",
                          "expireTime": "2020-04-18T08:52:17.000Z",
                          "isOldData": false
                      },
                      {
                          "id": "0f76a86c-d676-44d2-8c1f-536ce220fc0d",
                          "name": "openapi_site2",
                          "type": 51,
                          "productSerie": "miniprogram_",
                          "productType": "3",
                          "status": "RUNNING",
                          "createTime": "2019-04-18T08:52:17.000Z",
                          "expireTime": "2020-04-18T08:52:17.000Z",
                          "isOldData": false
                      }
                  ]
              },
              "success": true
          }

          站点续费

          接口描述

          本接口用于续费 AIPAGE 站点。支持批量续费。创建接口为同步接口,调用成功后会自动下单并扣款,扣款成功之后会开始续费资源,最终返回所有续费的资源详情。

          注意事项

          • 请务必在账户中提前预留足够的金额保证预付费订单的自动扣款成功,否则调用该 API 会失败并返回错误。
          • 如果在 24 小时内使用相同的参数和 clientToken,第二次则不会进行扣费续费,并返回上次续费订单操作的资源列表详情。
          • 所续费的站点资源必须是已经通过 https://console.bce.baidu.com/aipage/ 或者上述创建站点接口创建的已付费站点。平台前期公测期间创建的免费站点无法直接调用该接口进行续费(通过站点详情 isOldData 可以区分是否是公测测试站点)。
          • 续费站点操作的百度云账户必须和创建资源时的用户相同(资源管理员),否则调用该 API 会失败并返回错误。
          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          POST /v{version}/site/renew?clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {
              "items": [{
                  "config": {
                      "siteId": "xx", // 站点 ID,创建成功之后会返回。一个 36 位长度的 v4 版本 uuid
                      "time": 1,    // 续费时长
                  },
              }]
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          items List<SiteRenewItemModel> RequestBody参数 续费的站点配置

          SiteRenewItemModel

          参数名称 类型 是否必需 参数位置 描述
          config SiteRenewItemConfigModel RequestBody参数 续费内容配置

          SiteRenewItemConfigModel

          参数名称 类型 是否必需 参数位置 描述
          time String RequestBody参数 续费时间,单位为年,1 - 10 的自然整数
          siteId String RequestBody参数 创建时分配的站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回订单 ID 及创建的资源列表详情
          success Boolean 返回是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/site?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {
              "items": [{
                  "config": {
                      "siteId": "71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",
                      "time": 2, // 续费该站点的时长。单位为年,这里代表该站点续费 2 年。
                  }
              }, {
                  "config": {
                      "siteId": "835d097d-3b7e-4c01-9646-262cf75d30d6",
                      "time": 1, // 续费该站点的时长。单位为年,这里代表该站点续费 1 年。
                  }
              }]
          }

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          // 如果 24 小时内 clientToken 和参数都相同,则直接返回上次 clientToken 所创建的订单相关内容
          {
              "result": {
                  "orderId": "f6225dd2-e838-b4c7-45e4-f6225dd26676",
                  "sites": [
                      {
                          "id": "71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",    // 站点 ID
                          "name": "openapi_site",                          // 站点的名称
                          "type": 13,                                      // 标记套餐的类型,与 productSerie + productType 代表的意义相同
                          "productSerie": "site_miniprogram_",             // 产品系列,此处代表全网门户
                          "productType": "1",                              // 产品版本,此处代表基础版
                          "status": "RUNNING",                             // 站点状态
                          "createTime": "2019-04-18T08:54:16.000Z",        // 创建时间
                          "expireTime": "2023-04-18T08:54:16.000Z",        // 过期时间
                          "isOldData": false                               // 是否为试用版本用户
                      },
                      {
                          "id": "835d097d-3b7e-4c01-9646-262cf75d30d6",
                          "name": "openapi_miniprogram",
                          "type": 51,
                          "productSerie": "miniprogram_",
                          "productType": "4",
                          "status": "RUNNING",
                          "createTime": "2019-04-18T08:52:17.000Z",
                          "expireTime": "2021-04-18T08:52:17.000Z",
                          "isOldData": false
                      }
                  ]
              },
              "success": true
          }

          站点升级

          接口描述

          本接口用于升级 AIPAGE 站点。支持批量升级。创建接口为同步接口,调用成功后会自动下单并扣款,扣款成功之后会开始升级资源,升级成功会返回所有升级的资源详情。

          注意事项

          • 请务必在账户中提前预留足够的金额保证预付费订单的自动扣款成功,否则调用该 API 会失败并返回错误。
          • 升级站点操作的百度云账户必须和创建站点时的用户相同(资源管理员),否则调用该 API 会失败并返回错误。
          • 如果在 24 小时内使用相同的参数和 clientToken,第二次则不会进行扣费升级,并直接返回上次订单 ID 和升级的站点列表详情。
          • 所续费的站点资源必须是已经通过 https://console.bce.baidu.com/aipage/ 或者上述创建站点接口创建的已付费站点。平台前期公测期间创建的免费站点无法直接调用该接口进行升级(通过站点详情 isOldData 可以区分是否是公测测试站点)。
          • 升级接口单笔订单仅支持升级一个资源,多个资源仅有第一个资源(参数中 items 中的第一个 item)有效。
          • 套餐只能升级不能降级,全网门户系列无法升级为小程序门户系列,官网版本无法通过升级接口变为基础版本。

            • 全网门户官网版(site_miniprogram_3)无法变为全网门户展示版(site_miniprogram_2)
            • 小程序门户官网版(miniprogram_3)无法变为小程序门户展示版(miniprogram_2)
            • 全网门户展示版(site_miniprogram_2)无法变为小程序门户营销版(miniprogram_4)
          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          POST /v{version}/site/resize?clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {
              // 目前升级接口仅支持单资源升级,items 数组中仅第一个 item 有效
              "items": [{
                  "config": {
                      "siteId": "",                         // 站点 ID,创建成功之后返回的站点信息中的 ID
                      "comboName": "site_miniprogram_4",    // 升级后的套餐
                  },
              }]
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          items List<SiteResizeItemModel> RequestBody参数 创建的站点配置

          SiteResizeItemModel

          参数名称 类型 是否必需 参数位置 描述
          config SiteResizeItemConfigModel RequestBody参数 变配配置

          SiteResizeItemConfigModel

          参数名称 类型 是否必需 参数位置 描述
          comboName String RequestBody参数 变配套餐配置,详见套餐配置,例如 site_miniprogram_4
          siteId String RequestBody参数 创建时分配的站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回订单 ID 及创建的资源列表详情
          success Boolean 返回是否成功操作

          请求示例

          POST https://aipage.baidubce.com/v1/site?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          //  items 目前仅支持一个元素,多个元素会被忽略,最终只有第一个元素会出现在订单中
          {
              "items": [{
                  "config": {
                      "siteId": "71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",
                      "comboName": "site_miniprogram_4", // 升级后的站点套餐版本,这里的意思是升级该站点到 全网门户-营销版
                  }
              }]
          }

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          // 如果 24 小时内 clientToken 和参数都相同,则直接返回上次 clientToken 所创建的订单相关内容
          {
              "result": {
                  "orderId": "5c08ca2f-e838-b4c7-45e4-f6225dd26676",
                  "sites": [
                      {
                          "id": "71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",    // 站点 ID
                          "name": "openapi_site",                          // 创建站点的名称
                          "type": 101,                                      // 标记套餐的类型,与 productSerie + productType 代表的意义相同
                          "productSerie": "site_miniprogram_",             // 产品系列,此处代表全网门户
                          "productType": "4",                              // 产品版本,此处代表营销版
                          "status": "RUNNING",                             // 站点状态
                          "createTime": "2019-04-18T08:54:16.000Z",        // 创建时间
                          "expireTime": "2023-04-18T08:54:16.000Z",        // 过期时间
                          "isOldData": false                               // 是否为试用版本用户
                      }
                  ]
              },
              "success": true
          }

          站点列表

          接口描述

          本接口用于展示 AIPAGE 站点列表,返回当前用户的站点列表及详情。

          注意事项

          • limit 参数必须为 1 - 1000 的有效整数,默认为 10,不合法的 limit 参数则会无法调用此 API。
          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          GET /v{version}/site/list?limit=${limit}&marker=${marker} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          limit String Query参数 返回的站点数量,默认为 10
          marker String Query参数 创建的站点标记,代表从这个标记表示的站点开始获取

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回订单 ID 及创建的资源列表详情
          success Boolean 返回是否操作成功

          请求示例-1

          GET https://aipage.baidubce.com/v1/site/list?limit=3
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          响应示例-1

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          Server: BWS
          
          {
              "success":true,
              "result":{
                  "isTruncated": true,                                    // 代表后续仍有数据
                  "nextMarker":"b9ef663944b741789eaa40528c8c6bdf",        // 获取下一页数据时参数中需传入 marker
                  "sites": [                                              // 站点详情列表
                      {
                          "id":"71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",
                          "name":"openapi_site",
                          "type":101,
                          "productSerie":"site_miniprogram_",
                          "productType":"4",
                          "createTime":"2019-04-18T08:54:16.000Z",
                          "status":"STOPPED",
                          "expireTime":"2019-04-18T08:54:16.000Z",
                          "isOldData":true
                      },
                      {
                          "id":"835d097d-3b7e-4c01-9646-262cf75d30d6",
                          "name":"openapi_miniprogram",
                          "type":101,
                          "productSerie":"site_miniprogram_",
                          "productType":"4",
                          "createTime":"2019-04-18T08:52:17.000Z",
                          "status":"STOPPED",
                          "expireTime":"2019-04-18T08:52:17.000Z",
                          "isOldData":true
                      },
                      {
                          "id":"0f76a86c-d676-44d2-8c1f-536ce220fc0d",
                          "name":"openapi_miniprogram",
                          "type":101,
                          "productSerie":"site_miniprogram_",
                          "productType":"4",
                          "createTime":"2019-04-18T08:50:00.000Z",
                          "status":"STOPPED",
                          "expireTime":"2019-04-18T08:50:00.000Z",
                          "isOldData":true
                      }
                  ]
              }
          }

          站点详情

          接口描述

          本接口用于展示 AIPAGE 站点详情,返回查询的站点详细内容。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          GET /v{version}/site/{siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          siteId String URL参数 站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回查询的站点详情
          success Boolean 返回是否操作成功

          请求示例

          GET https://aipage.baidubce.com/v1/site/71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          响应示例-1

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true,
              "result": {
                  "id":"71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",
                  "name":"openapi_site",
                  "type":101,
                  "createdAt":"2019-04-18T08:54:16.000Z",
                  "productSerie":"site_miniprogram_",
                  "productType":"4",
                  "createTime":"2019-04-18T08:54:16.000Z",
                  "status":"RUNNING",
                  "expireTime":"2020-04-18T08:54:16.000Z",
                  "isOldData":false
              }
          }

          更改站点名称

          接口描述

          本接口用于更改 AIPAGE 站点的名称,最终返回查询的站点详情。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          POST /v{version}/site/{siteId}?action=name&clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"name": "xxxx"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          name String Body参数 修改后的站点名称

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回查询的站点详情
          success Boolean 是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/site/71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f?action=name&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"name": "test name"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true,
              "result": {
                  "id": "71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f",
                  "name": "test name",
                  "type": 101,
                  "productSerie": "site_miniprogram_",
                  "productType": "4",
                  "createTime": "2019-04-18T08:54:16.000Z",
                  "status": "RUNNING",
                  "expireTime": "2020-04-18T08:54:16.000Z",
                  "isOldData": false
              }
          }

          获取角色列表

          接口描述

          本接口用于查询 AIPAGE 站点配置的管理角色列表。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          GET /v{version}/role/list?siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          siteId String URL参数 站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回查询的站点成员列表
          success Boolean 是否操作成功

          请求示例

          GET https://aipage.baidubce.com/v1/role/list?siteId=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success": true,
              "result": [
                  {
                      "aclNames": "站点创建者,所有权限",
                      "name": "系统管理员",
                      "id": "23f5a31c-5d56-4bbb-a35e-46c91d73c5ed",
                      "acl": "admin",
                      "createdAt": "2020-05-25T04:31:04.000Z",
                      "updatedAt": "2020-05-25T04:31:04.000Z",
                      "deletedAt": "1970-01-01T00:00:00.000Z",
                      "siteId": "99f4f0ed-79f8-4426-9b43-650fdc364af4",
                      "usersNum": 1
                  },
                  {
                      "aclNames": "用户管理外所有权限",
                      "name": "副站长",
                      "id": "328a4db0-c942-411b-ae39-a2a8d58fa6aa",
                      "acl": "editor",
                      "createdAt": "2020-12-10T07:44:06.000Z",
                      "updatedAt": "2020-12-10T07:44:06.000Z",
                      "deletedAt": "1970-01-01T00:00:00.000Z",
                      "siteId": "99f4f0ed-79f8-4426-9b43-650fdc364af4",
                      "usersNum": 1
                  },
                  {
                      "aclNames": "除续费外所有权限",
                      "name": "站长",
                      "id": "5a2dde29-0226-4428-a35c-6c3747c9cc56",
                      "acl": "site-admin",
                      "createdAt": {
                          "fn": "NOW",
                          "args": []
                      },
                      "updatedAt": {
                          "fn": "NOW",
                          "args": []
                      },
                      "deletedAt": "1970-01-01T00:00:00.000Z",
                      "siteId": "99f4f0ed-79f8-4426-9b43-650fdc364af4",
                      "usersNum": 0
                  }
              ]
          }

          新增站点角色

          接口描述

          本接口用于新增 AIPAGE 站点自定义角色,最终返回操作结果。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          POST /v{version}/role?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"name": "role name", "acl": "1,2,3"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          name String Body参数 角色名称
          acl String Body参数 角色权限列表,多个英文逗号隔开,权限ID参考下表

          系统角色ID说明

          权限说明 权限ID
          设计、发布、预览网站 1
          站点管理 3
          内容管理 4
          互动管理 5
          用户管理 6
          开发者中心 7
          系统配置 8
          会员管理 9
          预约管理 10
          电商管理 11
          客服管理 12
          应用中心 14
          搜索优化 15
          编辑小程序 100
          发布审核小程序 300
          小程序管理 500

          更细粒度的功能权限ID参考站点后台自定义角色配置接口。

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/role?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"name": "自定义角色", "acl": "1,3,5"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success": true,
              "result": {
                  "aclNames": "设计、发布、预览网站、站点管理、互动管理",
                  "name": "自定义角色",
                  "createdAt": {
                      "fn": "NOW",
                      "args": []
                  },
                  "updatedAt": {
                      "fn": "NOW",
                      "args": []
                  },
                  "deletedAt": "1970-01-01T00:00:00.000Z",
                  "id": "42955978-a862-423e-9616-0854e28b75ce",
                  "siteId": "99f4f0ed-79f8-4426-9b43-650fdc364af4",
                  "acl": "1,3,5"
              }
          }

          删除站点角色

          接口描述

          本接口用于删除 AIPAGE 指定站点自定义角色,返回操作结果

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
          • 内置系统角色不允许删除

          请求结构

          DELETE /v{version}/role/{roleId}?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          roleId String PATH参数 角色 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          DELETE https://aipage.baidubce.com/v1/role/006710be-3f41-410f-96da-1219eefc691e?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          修改站点角色

          接口描述

          本接口用于修改 AIPAGE 站点角色的名称、权限信息,返回操作结果

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          PUT /v{version}/role/{roleId}?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"name": "new name", "acl", "3,5"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          roleId String PATH参数 角色 ID
          name String Body参数 角色新名称
          acl String Body参数 角色新权限

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          PUT https://aipage.baidubce.com/v1/role/006710be-3f41-410f-96da-1219eefc691e?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"acl": "1,3", "name": "新角色名称"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          获取成员列表

          接口描述

          本接口用于查询 AIPAGE 站点管理成员列表。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          GET /v{version}/user/list?siteId={siteId}&clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          siteId String URL参数 站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回查询的站点成员列表
          success Boolean 是否操作成功

          请求示例

          GET https://aipage.baidubce.com/v1/user/list?siteId=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success": true,
              "result": [
                  {
                      "isBanned": false,
                      "isAgent": false,
                      "phone": "",
                      "oauthData": {},
                      "id": "babd875e-6fae-49b7-80c5-292e8a09c30b",
                      "type": 0,
                      "showName": "zt0807****",
                      "realName": "zt0807****",
                      "qq": "",
                      "status": 0,
                      "oauthType": 0,
                      "portrait": "",
                      "createdAt": "2017-12-22T03:18:03.000Z",
                      "updatedAt": "2020-12-02T03:18:17.000Z",
                      "deletedAt": "1970-01-01T00:00:00.000Z",
                      "ap_user_site": {
                          "createdAt": "2020-05-25T04:31:04.000Z",
                          "updatedAt": "2020-05-25T04:31:04.000Z",
                          "siteId": "99f4f0ed-79f8-4416-9b43-650fdc364af4",
                          "userId": "babd875e-6fae-49bb-80c5-292e8109c30b"
                      },
                      "roles": [
                          {
                              "aclNames": "站点创建者,所有权限",
                              "name": "系统管理员",
                              "id": "23f5a31c-5d56-4bbb-a35e-46c91d73c5ed",
                              "acl": "admin",
                              "createdAt": "2020-05-25T04:31:04.000Z",
                              "updatedAt": "2020-05-25T04:31:04.000Z",
                              "deletedAt": "1970-01-01T00:00:00.000Z",
                              "siteId": "99f4f0ed-79f8-4426-9b43-650fdc364af4",
                              "ap_user_role": {
                                  "aclNames": "",
                                  "createdAt": "2020-05-25T04:31:04.000Z",
                                  "updatedAt": "2020-05-25T04:31:04.000Z",
                                  "roleId": "23f5a31c-5d56-4bbb-a35e-46c91d73c5ed",
                                  "userId": "babd875e-6fae-49b7-80c5-292e8109c30b"
                              },
                              "label": "系统管理员",
                              "value": "23f5a31c-5d56-4bbb-a35e-46c91d73c5ed"
                          }
                      ],
                      "aclName": "系统管理员",
                      "isAdmin": true
                  }
              ]
          }

          新增站点第三方成员

          接口描述

          本接口用于新增 AIPAGE 站点第三方平台管理成员并设置角色,最终返回操作结果。添加的用户通过第三方平台oauth免登进入管理后台,不需要有百度智能云账号。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
          • 使用本接口的前提是站点管理员已申请并完成 AIPAGE 第三方登录接入

          请求结构

          POST /v{version}/user?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"username": "xxxx", "nickname": "xxx", "uid": "001", "app": "appName", "role": "editor", "roleId": ""}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          username String Body参数 成员账号名
          nickname String Body参数 成员账号昵称
          portrait String Body参数 成员头像图片地址
          uid String Body参数 成员账号标识ID,需保持唯一
          app String Body参数 第三方平台oauth登录应用标识
          role String Body参数 设置成员的内置角色标识,参考下方内置角色说明
          roleId String Body参数 设置成员的自定义角色ID,从角色列表中获取

          内置角色说明

          角色标识 角色名称 角色权限
          site-admin 站长 除续费外所有权限
          editor 副站长 除续费和用户管理外所有权限
          dnr-user 域名服务商用户 除续费、用户管理、域名管理外所有权限

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/user?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"nickname": "nickname", "uid": "123", "role": "editor", "app": "app name"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          修改站点成员

          接口描述

          本接口用于修改 AIPAGE 站点成员的昵称、头像信息,返回操作结果

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          PUT /v{version}/user/{userId}?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"showName": "new name"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          userId String PATH参数 成员 ID
          showName String Body参数 成员新昵称
          portrait String Body参数 成员头像图片地址

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          PUT https://aipage.baidubce.com/v1/user/006710be-3f41-410f-96da-1219eefc691e?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"showName": "new-name"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          删除站点成员

          接口描述

          本接口用于删除 AIPAGE 指定站点非系统管理员成员,返回操作结果

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
          • 删除只删除账户在指定站点的角色,同个账户在其他站点的角色不受影响

          请求结构

          DELETE /v{version}/user/{userId}?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          userId String PATH参数 成员 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          DELETE https://aipage.baidubce.com/v1/user/006710be-3f41-410f-96da-1219eefc691e?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          设置成员角色

          接口描述

          本接口用于设置或修改 AIPAGE 站点成员的角色

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          POST /v{version}/user/setRole?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"id": "user id", "roleId": "role id"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          id String Body参数 成员ID
          roleId String Body参数 角色ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/user/setRole?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"id": "42955978-a862-423e-9616-0854e28b75ce", "roleId": "23f5a31c-5d56-4bbb-a35e-46c91d73c5ed"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          获取域名配置

          接口描述

          本接口用于查询 AIPAGE 站点域名配置信息,返回站点对应的大陆和香港的cname解析地址。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          GET /v{version}/domain/conf?siteId={siteId}&clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          siteId String URL参数 站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回查询的站点成员列表
          success Boolean 是否操作成功

          请求示例

          GET https://aipage.baidubce.com/v1/domain/conf?siteId=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success": true,
              "result": {
                  "hk": "aeae4a83ac456.hk.aipage.com", // 香港解析地址
                  "gz": "aeae4a83ac456.aipage.com" // 大陆解析地址
              }
          }

          查询域名列表

          接口描述

          本接口用于查询 AIPAGE 站点域名绑定列表,返回查询结果。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。

          请求结构

          GET /v{version}/domain/list?siteId={siteId}&clientToken={clientToken} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          siteId String URL参数 站点 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          result Object 返回查询的站点成员列表
          success Boolean 是否操作成功

          请求示例

          GET https://aipage.baidubce.com/v1/domain/list?siteId=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success": true,
              "result": [
                  {
                      "bindAt": "2020-12-07 19:06",
                      "id": "296c0f19-684f-4bce-92b7-3c46c0e2641a",
                      "domain": "aipage.cn",
                      "redirect": "",
                      "status": 34, // 34表示解析成功的大陆域,19表示解析成功的香港域名
                      "createdAt": "2020-12-07T11:06:21.000Z",
                      "updatedAt": "2020-12-07T11:07:14.000Z",
                      "siteId": "6242ee49-2966-4ef1-8b1d-113ab39f154c"
                  }
              ]
          }

          新增站点域名

          接口描述

          本接口用于新增 AIPAGE 站点绑定域名,添加前需确保域名DNS解析已在全国生效,否则可能会报错解析错误。

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
          • 发布到大陆的域名需要通过备案,否则将被封禁

          请求结构

          POST /v{version}/domain?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"domain": "www.aipage.com", "region": "gz"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          domain String Body参数 域名
          region String Body参数 发布区域,大陆: gz 香港: hk,默认是大陆

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/domain?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"domain": "www.aipage.com", "region": "gz"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success": true,
              "result": [
                  {
                      "bindAt": "2020-12-07 19:06",
                      "id": "296c0f19-684f-4bce-92b7-3c46c0e2641a",
                      "domain": "aipage.com",
                      "redirect": "",
                      "status": 34, // 34表示解析成功的大陆域,19表示解析成功的香港域名
                      "createdAt": "2020-12-07T11:06:21.000Z",
                      "updatedAt": "2020-12-07T11:07:14.000Z",
                      "siteId": "6242ee49-2966-4ef1-8b1d-113ab39f154c"
                  }
              ]
          }

          删除站点域名

          接口描述

          本接口用于删除 AIPAGE 指定站点绑定域名,返回操作结果

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
          • 删除域名后对应域名将无法访问站点,请谨慎操作

          请求结构

          DELETE /v{version}/domain/{domainId}?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          domainId String PATH参数 域名 ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          DELETE https://aipage.baidubce.com/v1/domain/006710be-3f41-410f-96da-1219eefc691e?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }

          设置域名301跳转

          接口描述

          本接口用于设置或修改 AIPAGE 站点域名301跳转配置,返回操作结果

          注意事项

          • authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
          • 域名301配置修改后大概10分钟后生效,跳转到域名需加到站点域名中,禁止多次跳转

          请求结构

          POST /v{version}/domain/setRedirect?clientToken={clientToken}&siteId={siteId} HTTP/1.1
          Host: aipage.baidubce.com
          Authorization: authorization string
          Body: {"domain": "aipage.com", "redirect": "www.aipage.com"}

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          clientToken String URL参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见幂等性
          siteId String URL参数 站点 ID
          domain String Body参数 待跳转域名
          redirect String Body参数 跳转目标域名,如果不设置或设置空则表示取消跳转

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          success Boolean 是否操作成功

          请求示例

          POST https://aipage.baidubce.com/v1/domain/setRedirect?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: aipage.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          Content-Type: application/json;charset=UTF-8
          
          Body:
          {"domain": "aipage.com", "redirect": "www.aipage.com"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
          
          {
              "success":true
          }
          上一篇
          通用说明
          下一篇
          附录