硅云帮助文档中心
搜索文档
热门搜索词:
产品简介
产品定价
常见问题
知识拓展
API参考
新购域名,此接口会自动从用户余额中扣除新购域名所需的费用
/domain-server/api/v1/domain/create
POST
| 字段 | 类型 | 最大长度 | 参数位置 | 默认必填 | 描述 |
| domainName | string | 64 | RequestBody | 域名,中文域名不需要转码 | |
| templateId | string | RequestBody | 模板Id,实名已通过的模板,开通的域名也是实名状态,若模板未实名或处于审核状态,开通的域名需要额外再实名一次 | ||
| year | int | 10 | RequestBody | 购买年分数 | |
| idempotent | string | 64 | RequestBody | 选填 | 幂等Id,防止创建成功但超时的情况,当传递相同的idempotent时,无论调用多少次,只会创建成功一次,建议传递uuid,和续费,升级操作不隔离 |
POST /domain-server/api/v1/domain/create HTTP/1.1
request_id: 2942183558593ffc9d75fb8e16793ff
api_key: 1706006863049654272
signature: d78a9449fb83094fc0ccebc082b003c930be6a323d7b9d42df7cd86195694979
Content-Type: application/json
{
"domainName":"testApi.com",
"templateId":"tm-3hc22eb24i222",
"year":1,
"idempotent":"123"
}data返回域名实例,实际以真实返回结果为准
{
"status": 2000,
"message": "success",
"data": {
"userAccount": "z8z87878",
"userEmail": "",
"languageType": "en",
"domainTld": ".com",
"domainName": "testApi.com",
"productName": ".com英文域名",
"beginTime": 1589508439273,
"endTime": 1621044439273,
"sourceProvider": "cn-bizcn",
"templateInfo": "tm-3hc22eb24i222",
"owner": "未知",
"personal": true,
"status": "OPENING",
"isSupportWhois": true,
"latestOrderId": "1706721689489899521",
"id": "dom-3hdvycq2a2223"
}
}实例数据结构:
| 字段 | 类型 | 描述 |
| id | string | 实例id |
| userAccount | string | 用户名 |
| status | string | 实例状态 |
| owner | string | 域名所有者 |
| personal | boolean | true为个人域名,由模板决定 |
| isSupportWhois | boolean | true为改类型域名支持whois保护,但前提是域名要通过了实名认证 |
您对该文档有什么建议?
本文导航