17EX 过期域名抢注竞价平台

API - V1.1

API申请规则
1、有包含域名业务的稳定运营的网站。
2、有已实名的17EX.COM账户。
3、网站运营主体与17EX.COM账户持有人一致。
4、提交工单申请开通API,工作人员会在5个工作日内对申请信息进行审核,审核通过后会予以开通。
版本 说明
V1.0 开放API
V1.1 修改联系人 上传认证资料,联系人类型为企业时,在上传企业证件信息的基础上还需上传联系人证件图片

API说明

1、请用 UTF-8 编码进行数据传输,返回的数据也是 UTF-8 编码的。


2、请不要滥用 API,否则将导致账户临时封禁,但不影响网站功能使用。

公共参数

所有的接口都需要这些参数,在此统一说明,下面的接口将不再列出。这些参数必须和接口参数一起提交。

字段 必选 类型及范围 说明
agency_id true string 代理id
timestamp true long 请求时间戳(毫秒)
signature true string 签名后的字符串

签名算法实现:

按照请求参数名的字母升序排列非空请求参数,使用URL键值对的格式拼接成字符串str1(对值进行URLEncode),将签名密钥拼接到待签名字符串(str1)最后面得到str2,对上述字符串(str2)取md5值。

举例说明计算过程
原始的请求参数是 BBB=1111,AAA=2222,DDD=3333
第一步,将上述参数 按照字典序进行升序排序,并使用URL键值对的格式拼接成字符串str1:
AAA=URLEncode(2222)&BBB=URLEncode(1111)&DDD=URLEncode(3333)
第二步,将您的AGENCY KEY(agency_key)追加到上述字符串尾部,得到取md5前的字符串str2:
AAA=URLEncode(2222)&BBB=URLEncode(1111)&DDD=URLEncode(3333)agency_key
第三步,对上述字符串str2取md5值
5b528dc9997caf1d1f9a2cf14805dc14 = md5(AAA=URLEncode(2222)&BBB=URLEncode(1111)&DDD=URLEncode(3333)agency_key)
因此,最终进行HTTP通信的参数列表为
BBB=1111,AAA=2222,DDD=3333,signature=5b528dc9997caf1d1f9a2cf14805dc14

公共返回参数说明

返回字段 必选 类型及范围 说明
code true int 0:失败,1:成功,2:处理中,9:签名错误,7:重复的请求,3:访问数据不存在,4:系统异常,5:参数缺失,6:无效的参数
remark false string 状态描述文字;接口请求失败原因;特殊说明
timestamp false long 请求时间戳(毫秒),通常与请求时参数一致
data true object 业务返回数据,详见各个接口

分页说明

返回字段 必选 类型及范围 说明
page_no true int 页码
page_size true int 单页数量,最大限制500
total_page true int 总页数
total_item true int 数据总条数
list true list 数据列表,详见各个接口

账户详情

请求方式及URL

GET https://www.17ex.com/api/account/info
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
user_id true string 用户Id
balance true float 账户余额
freeze true float 账户冻结金额

返回结果JSON示例

{
    "code": 1,
    "remark": "正常",
    "timestamp": 1560000000000,
    "data": {
        "user_id": "0000",
        "balance": 0,
        "freeze": 0,
    }
}
    复制

域名详情

请求方式及URL

GET https://www.17ex.com/api/domain/info
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain true string 域名

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
domain true string 域名
dns true string dns列表,英文逗号隔开
reg_time true long 注册时间
expire_time true long 域名过期时间
contact_id true string 联系人id
status true int 域名状态:
1:正常;2:已过期;3:赎回期;4:等待实名;5:实名审核中;6:PUSH中;7:已发送转移密码;8:转出中;9:交易中;10:实名审核失败

返回结果JSON示例

{
    "code": 1,
    "remark": "正常",
    "timestamp": 1560000000000,
    "data": {
        "domain": "test.com",
        "status": 1,
        "dns": "17ex1.dns.com,17ex2.dns.com",
        "reg_time": 1577808000000,
        "expire_time": 1609430400000,
        "contact_id": "100000000"
    }
}
    复制

域名列表

请求方式及URL

GET https://www.17ex.com/api/domain/list
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
page_no false int 页码
page_size false int 单页数量,最大限制500

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
domain true string 域名
dns true string dns列表,英文逗号隔开
reg_time true long 注册时间
expire_time true long 域名过期时间
contact_id true string 联系人id
status true int 域名状态:
1:正常;2:已过期;3:赎回期;4:等待实名;5:实名审核中;6:PUSH中;7:已发送转移密码;8:转出中;9:交易中;10:实名审核失败

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "domain": "test.com",
            "status": 1,
            "dns": "17ex1.dns.com,17ex2.dns.com",
            "reg_time": 1577808000000,
            "expire_time": 1609430400000,
            "contact_id": "100000000"
        }]
    }
}
    复制

域名续费

请求方式及URL

POST https://www.17ex.com/api/domain/renew
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain true string 域名
period true int 续费年限 1~10
expire_time true long 当前过期时间时间戳

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
task_no true string 域名续费任务编号,用于续费结果查询
state true int 业务状态,0:失败,1:成功,2:处理中
remark false string 业务结果说明

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "task_no": "21820190930183156501175299",
        "state": 2
    }
}
    复制

创建联系人

请求方式及URL

POST https://www.17ex.com/api/contact/create
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
template_name false string 模板名称,选填,25个字符以内
type true string I:个人|E:企业
person_name true string 个人姓名,与实名一致
person_name_en true string 英文个人姓名
company_name false string 企业名称,type=E时必填,与实名一致
company_name_en false string 英文企业名称,type=E时必填
email true string 联系人邮箱
phone true string 联系人手机
province true string 省份,如:北京
city true string 城市,如:北京
address true string 联系地址,64个字符以内
province_en true string 英文省份,如:BeiJing
city_en true string 英文城市,如:BeiJing
address_en true string 英文联系地址,64个字符以内
post_code true string 邮编
country_code false string 国家代码,默认+86

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
contact_id true string 联系人id

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "contact_id": "100000000"
    }
}
    复制

查询联系人信息

请求方式及URL

POST https://www.17ex.com/api/contact/info
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
contact_id true string 联系人id, 创建联系人返回

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
contact_id true string 联系人id
type true string I:个人|E:企业
person_name false string 个人姓名
person_name_en false string 英文个人姓名
company_name false string 企业名称,type=E时返回
company_name_en false string 英文企业名称,type=E时返回
email true string 联系人邮箱
phone true string 联系人手机
province true string 省份
province_en true string 英文省份
city true string 城市
city_en true string 英文城市
address true string 联系地址
address_en true string 英文联系地址
post_code true string 邮编
country_code true string 国家代码
status true string 联系人状态:
1:白名单;3:等待上传证件;5:注册局审核中;6:等待邮箱验证;9:审核失败
auth_type false string 证件类型
auth_no false string 证件号码

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "contact_id": "100000000",
        "type": "I",
        "person_name": "联系人",
        "person_name_en": "LianXiRen",
        "email": "email@17ex.com",
        "phone": "17171717171",
        "province": "北京",
        "city": "北京",
        "address": "详细地址",
        "province_en": "BeiJing",
        "city_en": "BeiJing",
        "address_en": "XiangXiDiZhi",
        "post_code": "100000",
        "country_code": "+86",
        "status": 5,
        "id_type": "SFZ",
        "id_auth_no": "110100202012031717"
    }
}
    复制

上传认证资料

请求方式及URL

POST https://www.17ex.com/api/contact/upload
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
contact_id true string 联系人id, 创建联系人返回
person_name true string 个人姓名,与创建联系人时一致,type=E 时为联系人姓名
person_type true string 证件类型,type=E 时为联系人证件类型
SFZ:身份证
HZ:护照
GAJMTX:港澳居民来往内地通行证
TWJMTX:台湾居民来往大陆通行证
WJLSFZ:外国人永久居留身份证
GAJZZ:港澳居民居住证
TWJZZ:台湾居民居住证
JGZ:军官证
QT:其他
person_auth_no true string 个人证件号码,type=E 时为联系人证件号码
person_file true string 个人证件图片Base64编码(可不参与签名),type=E 时为联系人证件图片
company_name true string 企业名称,与创建联系人时一致,type=E 时必填
company_type true string 证件类型,type=E 时必填
YYZZ:工商营业执照
ORG:组织机构代码证书
TYDM:统一社会信用代码证书
BDDM:部队代号
JDDWFW:军队单位对外有偿服务许可证
SYDWFR:事业单位法人证书
WGCZJG:外国企业常驻代表机构登记证
SHTTFR:社会团体法人登记证书
ZJCS:宗教活动场所登记证
MBFQY:民办非企业单位登记证书
JJHFR:基金会法人登记证书
LSZY:律师事务所执业许可证
WGZHWH:外国在华文化中心登记证
WLCZJG:外国政府旅游部门常驻代表机构批准登记证
SFJD:司法鉴定许可证
JWJG:境外机构证件
SHFWJG:社会服务机构登记证书
MBXXBX:民办学校办学许可证
YLJGZY:医疗机构执业许可证
GZJGZY:公证机构执业证
BJWSXX:北京市外国驻华使馆人员子女学校办学许可证
GAXJCN:港澳新闻机构常驻内地记者站登记证
JWFZDJ:境外非政府组织代表机构登记证书
WGZHXJ:外国驻华新闻机构证
GATLYJ:港澳台地区旅游部门常驻代表机构批准登记证
ZHSHXD:中华人民共和国社会信用代码证书
QTTYDM:其他统一代码
QT:其他
company_auth_no true string 企业证件号码,type=E 时必填
company_file true string 企业证件图片Base64编码,type=E 时必填(可不参与签名)

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000
}
    复制

域名联系人过户

请求方式及URL

POST https://www.17ex.com/api/contact/update
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain true string 域名
contact_id true string 联系人id,创建联系人返回

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
task_no true string 过户任务编号,用于过户结果查询
state true int 业务状态,0:失败,1:成功,2:处理中,3:等待上传认证资料,4:等待审核,5:审核中
remark false string 业务结果说明

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "task_no": "21820190930182608286623498",
        "state": 2
    }
}
    复制

域名修改DNS

请求方式及URL

POST https://www.17ex.com/api/dns/update
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain true string 域名
dns true string dns,多个用逗号(英文)隔开

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
task_no true string 修改DNS任务编号,用于修改DNS结果查询
state true int 业务状态,0:失败,1:成功,2:处理中
remark false string 业务结果说明

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "task_no": "21820190930183156501175299",
        "state": 2
    }
}
    复制

域名转出

请求方式及URL

POST https://www.17ex.com/api/domain/transfer/out
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain false string 域名,操作类型为转出申请时必填
option false int 操作类型(默认为转出申请):0:转出申请(发送转移密码);10:转出申请(获取转移密码);1:同意转出;2:取消转出;9:重新发送密码;
task_no false string 任务号,操作类型除转出申请外必填
remark false string 转出备注

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
password false string 域名转移密码,操作类型为【10】时返回
task_no true string 域名转出任务编号,用于域名转出后续操作以及结果查询
domain false string 域名
state true int 业务状态,2:处理中,10:密码已发送,11:转出成功,12:转出中,13:转出失败,14:取消转出处理中,15:转出已取消,16:确认转出处理中
remark false string 业务结果说明

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "task_no": "21820190930183156501175299",
        "domain": "test.cn",
        "state": 2
    }
}
    复制

域名PUSH

请求方式及URL

POST https://www.17ex.com/api/domain/push/request
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
receiver true string 接收人Id
domain true string,array PUSH的域名,多个英文逗号隔开(或数组);最多1000个
amount false float 请求金额,默认0

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
push_id true int push Id
fail false map 域名PUSH提交失败原因

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "push_id": 10000
    }
}
{
    "code": 0,
    "remark": "失败",
    "timestamp": 1560000000000,
    "data": {
        "fail": {
            "test1.cn": "该域名正在过户中,无法PUSH",
            "test2.cn": "该域名正在PUSH中,无法PUSH"
        }
    }
}
    复制

域名PUSH列表

请求方式及URL

GET https://www.17ex.com/api/domain/push/list
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
status false int 状态:0:等待接收; 1:已接收; 2:已撤回; 3:已拒绝
receiver false string 接收人Id
domain false string 域名,多个由英文逗号隔开,最多10个
page_no false int 页码
page_size false int 单页数量,最大限制500

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
push_id true int push Id
user_id true string 发起人Id
receiver true string 接收人Id
domain true list 的域名
amount false float 请求金额
status true int 状态:0:等待接收; 1:已接收; 2:已撤回; 3:已拒绝

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "push_id": 1,
            "user_id": "0000",
            "receiver": "0001",
            "domain": [
                "test1.cn",
                "test2.cn"
            ],
            "status": 1
        }]
    }
}
    复制

域名PUSH操作

请求方式及URL

POST https://www.17ex.com/api/domain/push/option
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
push_id true string push Id
option true int 操作:1:接收;2:撤销;3:拒绝
contact_id false string 接收联系人Id

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
push_id true int push Id
user_id true string 发起人Id
receiver true string 接收人Id
domain true list 的域名
amount false float 请求金额
status true int 状态:0:等待接收; 1:已接收; 2:已撤回; 3:已拒绝

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "push_id": 1,
        "user_id": "0000",
        "receiver": "0001",
        "domain": [
            "test1.cn",
            "test2.cn"
        ],
        "status": 1
    }
}
    复制

任务查询

请求方式及URL

GET https://www.17ex.com/api/task/query
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
task_type true string 任务类型:1:模板审核;2:过户;3:修改DNS;4:域名转出;5:域名续费
task_no false string 任务号,过户、修改DNS等接口返回 task_no,查询该类任务时必填
contact_id false string 联系人id,查询联系人审核状态时必填

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
task_no false string 任务编号
contact_id false string 联系人id
state true int 业务状态,0:失败,1:成功,2:处理中,3:等待上传认证资料,4:等待审核,5:审核中,10:密码已发送,11:转出成功,12:转出中,13:转出失败,14:取消转出处理中,15:转出已取消,16:确认转出处理中
remark false string 业务结果说明

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "contact_id": "100000001",
        "state": 4,
        "remark": "等待审核"
    }
}
    复制
{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "task_no": "21820190930183156501175299",
        "remark": "处理中",
        "state": 2
    }
}
    复制

预订通道说明

通道号 通道类型 起拍价格 预订保证金 抢注平台 支持后缀
2 _17_UPRE ¥50 ¥10 17EXUser .com,.net,.cn
3 DEL ¥75 ¥20 17EX .com
4 DEL ¥50 ¥10 66,22,naWang,eName,juMing,zzy,190,17EX .中国,.cn
5 DEL $27 $7 17EX,SnapNames,DropCatch .net,.com
7 DEL ¥22 ¥5 17EX .cn
8 ALI_PRE ¥69 ¥20 Aliyun .net,.com,.cc,.tv
9 SN_PRE $79 $7 SnapNames .com,.net
10 DEL $59 $10 17EX,SnapNames,DropCatch .net,.com
11 EN_PRE ¥119 ¥10 eName .net,.com
12 GD_PRE ¥470 ¥20 GoDaddy .org,.com,.net
13 _17_PRE ¥1 ¥20 17EX .net,.com
14 NC_PRE $4 $7 NameCheap .com,.net
15 NJ_PRE $69 $20 NameJet .net,.com
19 _17_ZT ¥50 ¥10 17EX .com,.net,.cn,.org,.cc
20 TX_PRE ¥119 ¥20 Tencent .cc,.com,.net

域名预订

请求方式及URL

POST https://www.17ex.com/api/book/reserve
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain true string 预订域名
channel true int 预订通道,见通道说明"通道号"
platform false string 预订平台,目前支持:17EX,66,22,EN,JM,NW,ZZY,SN,DC;
默认仅预订17EX平台,多个由英文逗号隔开,传 all 预订所有

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
domain true string 预订域名
bidding_id false int 竞价id

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "domain": "test.com",
        "bidding_id": "10000"
    }
}
    复制

预订记录

请求方式及URL

GET https://www.17ex.com/api/book/record
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
bidding_id false int 竞价id
delete_date false string 删除日期,格式yyyy-MM-dd
status false int 预订状态 1:等待抢注,2:抢注成功,3:取消,5:直接得标,9:竞价中,6:竞价得标,4:竞价失标,0:抢注失败
注:直接得标、竞价中、竞价得标、竞价失标为新增状态,历史预订记录不支持
domain false string 域名
page_no false int 页码
page_size false int 单页数量,最大限制500

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
bidding_id true int 竞价id
domain true string 域名
status true int 状态 1:等待抢注,2:抢注成功,3:取消,5:直接得标,9:竞价中,6:竞价得标,4:竞价失标,0:抢注失败
注:直接得标、竞价中、竞价得标、竞价失标为新增状态,历史预订记录不支持
delete_date true string 删除日期,格式yyyy-MM-dd
reserve_time true long 预订时间
channel true int 预订通道号
platform true string 预订平台

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "bidding_id": "10000",
            "domain": "test.com",
            "status": 1,
            "delete_date": "2021-01-01",
            "reserve_time": 1560000000000,
            "channel": 4,
            "platform": "17EX"
        }]
    }
}
    复制

出价

请求方式及URL

POST https://www.17ex.com/api/bidding/bid
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
bidding_id true int 竞价id
bid_price true float 出价金额

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
domain true string 域名
bidding_id false int 竞价id

返回结果JSON示例

{
    "code": 1,
    "remark": "出价成功,但您未领先",
    "timestamp": 1560000000000,
    "data": {
        "domain": "test.com",
        "bidding_id": "10000"
    }
}
    复制

出价记录

请求方式及URL

GET https://www.17ex.com/api/bidding/record
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
bidding_id true int 竞价id
page_no false int 页码
page_size false int 单页数量,最大限制500

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
bidding_id true int 竞价id
bid_alias true string 出价代号
bid_price true float 出价金额
bid_time true long 出价时间
is_mine true boolean 是否为我的出价

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "bidding_id": 10000,
            "bid_alias": "Bidder-1",
            "bid_price": 100,
            "bid_time": 1560000000000,
            "is_mine": true
        }]
    }
}
    复制

竞价详情

请求方式及URL

GET https://www.17ex.com/api/bidding/info
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
bidding_id true int 竞价id

业务返回(data),另见公共返回参数说明

字段 必选 类型及范围 说明
domain true string 域名
bidding_id true int 竞价id
type true string 竞价类型:17_DEL,66_DEL,EN_DEL,SN_DEL,SN_PRE,ALI_PRE
currency false string 币种 USD:美元,CNY:人民币
max_bid false float 最高出价
next_bid false float 下次有效出价
my_bid false float 我的最后出价
proxy_price false float 我的代理价
is_leader false boolean 是否领先
is_reserve_met false boolean 是否超过保留价
status true string 状态:
1:已预订;2:领先;3:落后;4:等待付款;5:等待交割;6:已交割;7:已违约;8:域名被赎回;9:域名已删除;10:抢注失败;0:未得标
start_time false long 起拍时间
end_time false long 结拍时间
last_pay_time false long 最后支付时间
deliver_time false long 预计交割时间
usd_rate false float 美元汇率
transfer_in_price false float 转入价格
coupon_price false float 优惠价格
real_pay_price false float 实际付款金额

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "bidding_id": 10000,
        "domain": "test.com",
        "type": "17_DEL",
        "currency": "CNY",
        "max_bid": 50,
        "is_leader": true,
        "is_reserve_met": true,
        "status": "2",
        "start_time": 1560000000000,
        "end_time": 1560000000000
    }
}
    复制

我参与的竞价列表

请求方式及URL

GET https://www.17ex.com/api/bidding/list
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
status true int 1:已预订;11:竞价中;2:领先;3:落后;4:等待付款;5:等待交割;6:已交割;7:已违约;8:域名被赎回;9:域名已删除;0:未得标
page_no false int 页码
page_size false int 单页数量,最大限制500
end_date false string 结拍日期,格式yyyy-MM-dd
delete_date false string 删除日期,格式yyyy-MM-dd

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
domain true string 域名
bidding_id true int 竞价id
type true string 竞价类型:17_DEL,66_DEL,EN_DEL,SN_DEL,SN_PRE,ALI_PRE
currency false string 币种 USD:美元,CNY:人民币
max_bid false float 最高出价
next_bid false float 下次有效出价
my_bid false float 我的最后出价
proxy_price false float 我的代理价
is_leader false boolean 是否领先
is_reserve_met false boolean 是否超过保留价
status true string 状态:
1:已预订;2:领先;3:落后;4:等待付款;5:等待交割;6:已交割;7:已违约;8:域名被赎回;9:域名已删除;10:抢注失败;0:未得标
start_time false long 起拍时间
end_time false long 结拍时间
last_pay_time false long 最后支付时间
deliver_time false long 预计交割时间
usd_rate false float 美元汇率
transfer_in_price false float 转入价格
coupon_price false float 优惠价格
real_pay_price false float 实际付款金额

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "bidding_id": 10000,
            "domain": "test.com",
            "type": "17_DEL",
            "currency": "CNY",
            "max_bid": 50,
            "is_leader": true,
            "is_reserve_met": true,
            "status": "2",
            "start_time": 1560000000000,
            "end_time": 1560000000000
        }]
    }
}
    复制

竞价列表

请求方式及URL

GET https://www.17ex.com/api/bidding/all
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
page_no false int 页码
page_size false int 单页数量,最大限制500
bidding_id false int 竞价id
type false string 竞价类型:17_DEL,66_DEL,EN_DEL,SN_DEL,SN_PRE,ALI_PRE;多个英文逗号隔开

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
domain true string 域名
bidding_id true int 竞价id
type true string 竞价类型:Delete,PreRelease
currency false string 币种 USD:美元,CNY:人民币
max_bid false float 最高出价
next_bid false float 下次有效出价
end_time false long 结拍时间
usd_rate false float 美元汇率
transfer_in_price false float 转入价格

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "bidding_id": 10000,
            "domain": "test.com",
            "type": "17_DEL",
            "currency": "CNY",
            "max_bid": 50,
            "end_time": 1560000000000
        }]
    }
}
    复制

一口价列表

请求方式及URL

GET https://www.17ex.com/api/domain/buy/list
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
page_no false int 页码
page_size false int 单页数量,最大限制500
domain false string 域名

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
domain true string 域名
intro false string 域名描述
price true double 价格
reg_time false long 域名注册时间时间戳(毫秒)
expire_time false long 域名过期时间时间戳(毫秒)
offline_time true long 域名下线时间时间戳(毫秒)
transfer_fast true Boolean 是否支持确认转出
transfer_cancel true Boolean 是否支持取消转出

返回结果JSON示例

{
    "code": 1,
    "remark": "正常",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 1,
        "total_page": 1,
        "total_item": 1,
        "list": [{
            "domain": "test.com",
            "intro": "test、测试",
            "price": "10000",
            "reg_time": 1577808000000,
            "expire_time": 1609430400000,
            "offline_time": "1700000000000"
        }]
    }
}
    复制

一口价购买

请求方式及URL

GET https://www.17ex.com/api/domain/buy
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
domain true string 域名
price true double 购买价格

业务返回(data)

字段 必选 类型及范围 说明
code true int 0:购买失败,1:购买成功
remark false string 失败原因
timestamp false long 请求时间戳(毫秒),通常与请求时参数一致

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000
}
    复制

资金明细

请求方式及URL

GET https://www.17ex.com/api/finance/list
    复制

请求参数

字段 必选 类型及范围 说明
公共参数 true - 公共参数说明
status false int 状态,1:交易成功(默认);3:冻结中
domain false string 域名
trade_date false string 交易日期,格式yyyy-MM-dd
begin_time false string 查询起始时间(交易时间),格式yyyy-MM-dd HH:mm:ss
end_time false string 查询终止时间(交易时间),格式yyyy-MM-dd HH:mm:ss
page_no false int 页码
page_size false int 单页数量,最大限制500

业务返回(data),另见公共返回参数说明

分页数据 true - 分页说明
list元素 true object 如下
字段 必选 类型及范围 说明
type true int 收支类型,1:收入;2:支出
business true string 业务描述
amount true double 金额
status true int 状态,0:处理中;1:交易成功;2:交易失败;3:冻结中
trade_time false long 交易时间戳(毫秒)
freeze_time false long 冻结时间戳(毫秒)
remark false string 备注

返回结果JSON示例

{
    "code": 1,
    "remark": "成功",
    "timestamp": 1560000000000,
    "data": {
        "page_no": 1,
        "page_size": 3,
        "total_page": 1,
        "total_item": 3,
        "list": [{
            "type": 2,
            "business": "域名预订",
            "amount": 10,
            "status": 3,
            "freeze_time": 1560000000000,
            "remark": "test.com"
        }, {
            "type": 2,
            "business": "一口价",
            "amount": 1000,
            "status": 1,
            "trade_time": 1560000000000,
            "remark": "test.com"
        }, {
            "type": 1,
            "business": "线下充值",
            "amount": 1000,
            "status": 1,
            "trade_time": 1560000000000,
            "remark": ""
        }]
    }
}
    复制