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

    调用说明

    请求地址
      https://apiv2.xinnet.com
      仅支持https协议。
    请求方法
      仅支持 POST 方式,content-type为:application/json,采用requestBody方式传递业务数据。
    公共请求参数
      公共请求参数通过header进行传递,内容为下面2项,必填的。
    参数名必选类型说明
    timestamp是string时间戳,注意是UTC的0时区,再重点强调一遍:是0时区,不是我们所处的东8区。格式为:"yyyyMMdd'T'HHmmss'Z'",比如我们现在的时间是"2024-06-05 18:08:32",那么 timestamp 将是 "20240605T100832Z"
    authorization是string格式为:algorithm + 空格 + Access=xxxxx, + 空格 + Signature=yyyyy
    关于 authorization 的格式说明如下:
    algorithm:必须是 HMAC-SHA256
    xxxxx:代理号,比如 agent12345,注意别忘记最后需要一个英文逗号
    yyyyy:生成的签名字符串,签名算法详细见签名算法说明
    举例如下:
    HMAC-SHA256 Access=agent12345, Signature=bbcebdf1d93fbd8dfbd18313b29e645014c98e307d8f3a88b7517199bad564a6
    公共返回参数
    参数名必选类型说明
    code是string"0"表示成功,其余非"0"的表示错误,具体见下面常见响应码
    msg是string消息
    data是object格式为json
    requestId是string当出问题的时候,调用方用此提供给我们来排查问题
    常见响应码
    响应码说明
    0请求正常
    1请求失败,具体原因查看msg中的说明
    350002签名错误
    350003找不到对应的app,即 agentCode 不正确
    350004API服务未开通或已过期
    350005系统错误,请稍后重试
    350006您的域名尚未通过域名实名制审核暂时无法进行此操作,请您尽快提交域名实名制审核,审核通过后可正常使用
    350007您的模版尚未通过域名实名制审核暂时无法进行此操作,请您尽快提交域名实名制审核,审核通过后可正常使用
    350008您的模版已进入黑名单,无法进行此操作
    350009域名信息不存在
    350010域名信息错误
    350011当前域名无操作权限
    350012重点保护域名限制此操作
    350013重点保护账号限制此操作
    350014保留域名限制此操作
    350015域名已过服务期
    350016域名包含serverUpdateProhibited状态,无法进行此操作
    350017域名包含clientUpdateProhibited状态,无法进行此操作
    350018域名包含serverHold状态,无法进行此操作
    350019域名包含clientHold状态,无法进行此操作
    350020域名包含pendingDelete状态,无法进行此操作
    350021域名包含pendingTransfer状态,无法进行此操作
    350022域名包含clientRenewProhibited状态,无法进行此操作
    350023域名包含serverRenewProhibited状态,无法进行此操作
    350024商品不存在,无法进行此操作
    350025商品价格错误,无法进行此操作
    350026订单处理失败,请稍后重试
    350027预付款处理失败,请稍后重试
    350028预付款余额不足
    350029域名类型暂不支持此操作
    350030当前账号无操作权限
    350031域名已经进入偿还期,无法进行此操作
    350032当前操作响应超时
    350033模版信息不存在
    350034持有人信息不存在
    350035联系人信息不存在
    350036域名正在管理权变更中,无法进行此操作
    350037非新网域名,无法进行此操作
    350038资料状态审核中,无法进行此操作
    350039资料状态审核通过,无法进行此操作
    350040持有人证件号码格式错误或长度超限(不超过30位)
    350041证件资料格式错误,请上传jpg/jpeg格式文件,最大5M
    350042模版名称不能为空
    350043域名包含禁止转移状态,无法进行此操作
    354000模版信息重复
    354001持有人名称中文格式错误
    354002当前模版有关联域名,无法进行此操作
    355000参数不能为空,具体原因查看msg中的说明
    355010访问拒绝
    355020IP地址访问拒绝
    355030操作的资源已经存在,具体原因查看msg中的说明
    355040操作的资源没有存在,具体原因查看msg中的说明
    355050参数格式错误,具体原因查看msg中的说明
    355060数据冲突,具体原因查看msg中的说明
    355070该资源下存在子节点,具体原因查看msg中的说明
    355080接口请求超出限制
    355090不允许的操作,具体原因查看msg中的说明
    990000未知的错误,需要联系我们进一步分析
    修改于 2024-06-20 06:47:31
    下一页
    签名算法