API 文档
取消
文档目录
    加载中
文档中心 API 文档 创建订单

创建订单

文档中心 API 文档

1. 接口描述

本接口 Dns.CreateDeal 用于创建订单。
接口请求地址：https://dnsapi.cn/Dns.CreateDeal
HTTP请求方式：POST

2. 请求参数

参数名称 必选 类型 描述
deal_type 是 Int 订单类型：
1：新购
2：续费
3：套餐升级（增值服务暂时只支持新购）
goods_type 是 Int 商品类型：
1：域名套餐
2： 增值服务
domain 否 String 需要绑定套餐的域名，如 dnspod.cn，如果是续费或升级，domain 参数必须要传，新购可不传。
time_span 否 Int 套餐时长：
1. 套餐以月为单位（按月只能是 3、6 还有 12 的倍数），套餐例如购买一年则传12，最大120 。
2. 升级套餐时不需要传。
3. 增值服务的时长单位为年，买一年传1（增值服务新购按年只能是 1，增值服务续费最大为 10）。
goods_child_type 是 string 套餐类型：
DP_PLUS：专业版
DP_EXPERT：企业版
DP_ULTRA：尊享版

增值服务类型
LB：负载均衡
URL：URL转发
DMONITOR_TASKS：D监控任务数
DMONITOR_IP：D监控备用 IP 数
CUSTOMLINE：自定义线路数
goods_num 是 Int 增值服务购买数量，如果是域名套餐固定为1，如果是增值服务则按以下规则：
负载均衡、D监控任务数、D监控备用 IP 数、自定义线路数、URL 转发（必须是5的正整数倍，如 5、10、15 等）
new_package_type 否 string 套餐类型，需要升级到的套餐类型，只有升级时需要。
auto_renew 否 Int 是否开启自动续费，1 开启，2 不开启（增值服务暂不支持自动续费），不传默认为 2 不开启

3. 响应码

数字码 标识 描述
9 deal_type_invalid 订单类型错误
14 domain_invalid 域名错误
2 goods_type_invalid 商品类型错误
3 goods_num_invalid 数量错误
4 goods_child_type_invalid 套餐类型错误
7 new_package_type_invalid 升级套餐类型错误
11 time_span_invalid 套餐时长错误
8 package__upgrading 新版套餐升级中
10 domain_effect_or_invalidated 不允许操作生效或生效中的域名
13 params_illegal 参数错误

4. 输出参数

参数名称 类型 描述
big_deal_id string 大订单号，一个大订单号下可以有多个子订单，说明是同一次下单
deals array 子订单号
status Json 公共返回参数，code=‘1’说明成功

示例

Curl -X https://dnsapi.cn/ Dns.CreateDeal -d ‘login_token=LOGIN_TOKEN&deal_type=1&domain=dnspod.cn&goods_type=1&time_span=1&goods_child_type=DP_PLUS&goods_num=1&auto_renew=1&format=json’

返回示例如下：

JSON:

{
    "status": {
        "code":"1",
        "message":"Action completed successful",
        "created_at":"2015-01-18 22:12:35"
},
"big_deal_id":"2021042313242309098981923090934",
    "deals": [{
        "deal_id":"238112403",
        "deal_name":"2021042313242309098981923090934"
    }]
}
最近更新于 2021-12-29 19:38

DNSPod 域名检测工具

查询域名信息，快速排查网站问题

网站自助排障

快速判断问题、提供合适的解决方案

相关文档