硅云幫助文檔中心
搜索文檔
熱門搜索詞:
產品簡介
產品定價
常見問題
知識拓展
API參考
新購域名
新購域名,此接口會自動從用戶余額中扣除新購域名所需的費用
/domain-server/api/v1/domain/create
POST
字段 | 類型 | 最大長度 | 參數位置 | 默認必填 | 描述 |
domainName | string | 64 | RequestBody | 域名,中文域名不需要轉碼 | |
templateId | string | RequestBody | 模板Id,實名已通過的模板,開通的域名也是實名狀態(tài),若模板未實名或處于審核狀態(tài),開通的域名需要額外再實名一次 | ||
year | int | 10 | RequestBody | 購買年分數 | |
idempotent | string | 64 | RequestBody | 選填 | 冪等Id,防止創(chuàng)建成功但超時的情況,當傳遞相同的idempotent時,無論調用多少次,只會創(chuàng)建成功一次,建議傳遞uuid,和續(xù)費,升級操作不隔離 |
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 | 實例狀態(tài) |
owner | string | 域名所有者 |
personal | boolean | true為個人域名,由模板決定 |
isSupportWhois | boolean | true為改類型域名支持whois保護,但前提是域名要通過了實名認證 |
您對該文檔有什么建議?
本文導航