API

版本	说明
V1.0	开放API
V1.1	修改联系人上传认证资料，联系人类型为企业时，在上传企业证件信息的基础上还需上传联系人证件图片

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
    }
}
    复制

请求方式及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：重新发送密码；说明：直接申请转移密码（10）时，第三方域名如不能及时查询到密码，需要间隔一段时间后再次调用该接口重新获取
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
    }
}
    复制

请求方式及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"
        }
    }
}
    复制

请求方式及URL

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

请求参数

字段	必选	类型及范围	说明
公共参数	true	-	见公共参数说明
push_id	false	int	push Id
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
        }]
    }
}
    复制

请求方式及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	￥90	￥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	￥199	￥20	Aliyun	.tv，.cc，.com，.net，.art，.asia，.biz，.chat，.cloud，.club，.co，.company，.design，.fans，.fit，.fun，.group，.host，.icu，.info，.ink，.kim，.link，.live，.love，.ltd，.mobi，.online，.press，.pro，.pub，.shop，.site，.space，.store，.tech，.top，.vip，.wang，.website，.wiki，.work，.xin，.xyz，.zone，.red，.ren，.beer，.luxe，.yoga
9	SN_PRE	$79	$7	SnapNames	.com，.net
10	DEL	$79	$10	17EX，SnapNames，DropCatch	.net，.com
11	EN_PRE	￥119	￥10	eName	.net，.com
12	GD_PRE	￥295	￥20	GoDaddy	.net，.com，.org
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	￥198	￥20	Tencent	.com，.net
21	ALI_XZ	￥199	￥20	Aliyun	.cn
22	XW_PRE	￥198	￥20	XinWang	.com
23	_190_PRE	￥198	￥20	190	.com

请求方式及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": ""
        }]
    }
}
    复制

API - V1.1

API说明

公共参数

公共返回参数说明

分页说明

账户详情

域名详情

域名列表

域名续费

创建联系人

查询联系人信息

上传认证资料

域名联系人过户

域名修改DNS

域名转出

域名PUSH

域名PUSH列表

域名PUSH操作

任务查询

预订通道说明

域名预订

预订记录

出价

出价记录

竞价详情

我参与的竞价列表

竞价列表

一口价列表

一口价购买

资金明细