调用说明
https://apiv2.xinnet.com
仅支持 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 |
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 不正确 |
| 350004 | API服务未开通或已过期 |
| 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 | 访问拒绝 |
| 355020 | IP地址访问拒绝 |
| 355030 | 操作的资源已经存在，具体原因查看msg中的说明 |
| 355040 | 操作的资源没有存在，具体原因查看msg中的说明 |
| 355050 | 参数格式错误，具体原因查看msg中的说明 |
| 355060 | 数据冲突，具体原因查看msg中的说明 |
| 355070 | 该资源下存在子节点，具体原因查看msg中的说明 |
| 355080 | 接口请求超出限制 |
| 355090 | 不允许的操作，具体原因查看msg中的说明 |
| 990000 | 未知的错误，需要联系我们进一步分析 |
修改于 2025-08-25 01:21:46