域名APIv2-对外接口
  1. 域名接口
域名APIv2-对外接口
  • 调用说明
  • 签名算法
  • 域名接口
    • 获取外部域名转移密码
    • 取消外部域名转出
    • 外部域名异步任务结果查询
    • 查询域名是否可注册
    • 获取域名转移密码
    • 重新获取域名转移密码
    • 查询域名转出状态
    • 取消域名转出
    • 提交域名转入
    • 查询域名转入结果
    • 取消域名转入
    • 获取域名管理密码
    • 修改域名管理密码
    • 注册本域名dns
    • 修改本域名dns
    • 删除本域名dns
    • 查询本域名dns
    • 添加域名dnssec
    • 删除域名dnssec
    • 查询域名dnssec
    • 设置域名状态
    • 提交域名管理权变更
    • 查询域名管理权变更结果
    • 查询域名词性
    • 域名注册
    • 域名续费
    • 域名赎回
    • 域名过户
    • 修改域名DNS
    • 下载域名证书
    • 上传域名实名资料
    • 查询域名信息
    • 查询域名注册结果
    • 查询域名过户结果
    • 查询域名赎回结果
    • 查询.商标域名注册进度
    • 查询域名管理权变更被转出域名信息
    • 查询域名管理权变更转入域名信息
    • 域名管理权密码变更接口
    • 查询域名分页列表
  • 模版接口
    • 创建模板
    • 修改模板
    • 删除模板
    • 上传资料
    • 查询模板资料
    • 查询模板列表
    • 查询模板详情
    • 查询国内省市级联
    • 查询复审模板列表
  • 账户接口
    • 余额查询
  • 产品价格接口
    • 域名产品价格查询
  • 增值服务接口
    • 注册局锁购买
    • 注册局锁关闭
    • 注册局锁开启
    • 注册局锁查询
    • 注册局锁续费
    • Whois信息保护开通
    • Whois信息保护续费
    • Whois信息保护查询
  • 解析接口
    • 检查域名
    • 开通域名
    • 查询域名
    • 设置域名状态
    • 域名解析记录添加
    • 域名解析记录删除
    • 域名解析记录更新
    • 查询单条域名解析记录
    • 查询域名解析记录列表
    • 设置解析状态
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 域名接口

域名注册

简要描述:
域名注册
请求URL:
https://apiv2.xinnet.com/api/domain/create
请求方式:
POST
公共请求参数:
请参见《调用说明》
参数:
参数名是否必选类型说明示例
domainName是string域名xinnet.com
templateName是string模版名称审核通过的模版
year是int注册年限,1~10的整数1
price否string注册价格,溢价词时必填
registrar否string注册商标识,默认xinnetxinnet
dns1是string主DNSns11.xincache.com
dns2是string辅DNSns12.xincache.com
dns3否stringDNS3
dns4否stringDNS4
dns5否stringDNS5
dns6否stringDNS6
dns7否stringDNS7
dns8否stringDNS8
返回code说明(v2版本和v1版本对应关系)
v2 codev1接口返回说明
350002client-null代理号为空
350002verify-null没有摘要
350002charset-null编码为空
350002testFlag-null编码内容验证为空
350002charset-invalid编码无效
350002testFlag-wrong编码内容验证失败
350002client-noexist代理号不存在
350002verify-failure摘要认证失败
350002auth-failure认证错误
350002client-invalid代理号格式无效
355000name-null域名为空
355000tname-null模板名称为空
--period-null域名注册年限为空
355050name-invalid域名包含无效字符
--tname-invalid模板名称包含无效字符或超长
355050period-invalid域名注册年限无效
355050DNS1-invalidDNS服务器名称含无效字符或超长
355050DNS2-invalidDNS服务器名称含无效字符或超长
355050DNS3-invalidDNS服务器名称含无效字符或超长
355050DNS4-invalidDNS服务器名称含无效字符或超长
355050DNS5-invalidDNS服务器名称含无效字符或超长
355050DNS6-invalidDNS服务器名称含无效字符或超长
355050tname-noexist模板不存在
--period-noexist没有找到域名注册年限
355050name-wrong错误的域名后缀
0reg-success域名注册成功
1reg-failure域名注册失败
--db-fail数据库连接失败
--certtype-nullasia证件类型为空(限asia域名)
--certcode-nullasia证件号码为空(限asia域名)
--entitytype-nullasia实体类型为空(限asia域名)
--certtype-invalid证件类型无效(限asia域名)
--certcode-invalid证件号码无效(限asia域名)
--entitytype-invalid实体类型无效(限asia域名)
530024goods-invalid商品未上线
--goods-unauthorized代理号未授权此类商品
--reg-contact-failure上游注册域名联系人失败
--reg-DNS-failure上游注册域名DNS失败
--reg-name-failure上游注册域名信息失败
530025price-failure获取商品价格失败
1name-exist域名已存在
530005system-error系统错误
530032timeout网络超时
530028credit-fail检查当前账户余额,不足则返回信息
530007rstatus-error模板实名制未通过注册失败
530008template-in-blacklist模板在注册局黑名单
请求示例
{
    "domainName":"xinnet.com",
    "templateName":"模版名称123",
    "year":1,
    "price":null,
    "registrar":"",
    "dns1":"ns11.xincache.com",
    "dns2":"ns12.xincache.com",
    "dns3":"",
    "dns4":"",
    "dns5":"",
    "dns6":"",
    "dns7":"",
    "dns8":""
}
公共响应返回
请参见《调用说明》
返回信息列表
返回信息说明
code执行结果代码:0-成功,非0-失败
msg执行结果说明
requestId本次请求唯一ID
data返回json对象
备注
成功结果示例
{
    "code":"0",
    "msg":"请求成功",
    "requestId":"mL7Uv3j2gMw0mBF8bj5",
    "data":null
}
错误结果示例
{
    "code":"355050",
    "msg":"prefix参数格式错误,xn--请转换为中文",
    "requestId":"mL7Uv3j2gMw0mBF8bj5",
    "data":null
}
修改于 2025-08-25 01:21:46
上一页
查询域名词性
下一页
域名续费
Built with