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 域名检测工具

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

官方微信群

加入微信群,一起畅聊,一起吐槽

打开微信扫一扫