硅云帮助文档中心
搜索文档
热门搜索词:
产品简介
产品定价
常见问题
知识拓展
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保护,但前提是域名要通过了实名认证 |
您对该文档有什么建议?
本文导航