最新活动 新春特惠

产品

硅云帮助文档中心

搜索文档

热门搜索词:

新购域名

更新时间:2020-05-21 17:07  版本:v1.0
分享到:
我要反馈 
收藏 我的收藏

简要描述:


    新购域名,此接口会自动从用户余额中扣除新购域名所需的费用


请求url:


/domain-server/api/v1/domain/create


请求方式:


POST


请求参数:


字段
类型最大长度参数位置默认必填
描述
domainNamestring64RequestBody
域名,中文域名不需要转码
templateIdstring
RequestBody
模板Id,实名已通过的模板,开通的域名也是实名状态,若模板未实名或处于审核状态,开通的域名需要额外再实名一次
yearint10RequestBody
购买年分数
idempotentstring64RequestBody选填幂等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"
    }
}


实例数据结构:


字段类型
描述
idstring实例id
userAccount
string用户名
status
string实例状态
owner
string域名所有者
personal
booleantrue为个人域名,由模板决定
isSupportWhois
booleantrue为改类型域名支持whois保护,但前提是域名要通过了实名认证








您对该文档有什么建议?

您对该文档的评分:

本文导航

简要描述:

请求url:

请求方式:

请求参数:

请求示例:

返回示例:

搜索文档