新增站点域名
更新时间:2021-09-02
接口描述
本接口用于新增 AIPAGE 站点绑定域名,添加前需确保域名DNS解析已在全国生效,否则可能会报错解析错误。
注意事项
- authorization header 签名时必须签名 host 头部,同时推荐签名所有 x-bce 开头 header。
- 发布到大陆的域名需要通过备案,否则将被封禁
请求结构
Plain Text
1POST /v{version}/domain?clientToken={clientToken}&siteId={siteId} HTTP/1.1
2Host: aipage.baidubce.com
3Authorization: authorization string
4Body: {"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 | 是否操作成功 |
请求示例
Plain Text
1POST https://aipage.baidubce.com/v1/domain?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
2Host: aipage.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4Content-Type: application/json;charset=UTF-8
5
6Body:
7{"domain": "www.aipage.com", "region": "gz"}
响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6
7{
8 "success": true,
9 "result": [
10 {
11 "bindAt": "2020-12-07 19:06",
12 "id": "296c0f19-684f-4bce-92b7-3c46c0e2641a",
13 "domain": "aipage.com",
14 "redirect": "",
15 "status": 34, // 34表示解析成功的大陆域,19表示解析成功的香港域名
16 "createdAt": "2020-12-07T11:06:21.000Z",
17 "updatedAt": "2020-12-07T11:07:14.000Z",
18 "siteId": "6242ee49-2966-4ef1-8b1d-113ab39f154c"
19 }
20 ]
21}