一、对于新网域名注册代理接口, 大家需要知道它到底是什么个情况。
新网（eNet）提供了一个叫做域名注册代理API的东西。支持开发者用编程的方式来一次性搞定域名注册、续费和转入这些事儿。所谓的代理模式, 就是说开发者手里得拿着新网给的正式代理商账号。
开发者能够通过调接口, 直接用到新网的域名注册服务。不需要每次单跑的时候都去登录后台搞手工操作。这种方式适合那些希望在自家系统里把域名业务包进去的平台公司。也适合开发工具的软件开发商使用。
二、接入前提
1. 新网代理商资质申请这件事会被完成, 然后代理账号能够被取得, 另外API密钥也就是AppKey与AppSecret也会被拿到。
2. 我们的服务器是支持HTTPS出站访问这一事情的, 我们新网接口的端点具体是什么样子呢? 它就是https://api.net.cn这个, 是不支持那种HTTP明文调用的。
3. 所有的请求, 都得携带那个鉴权方面的标头部分内容, 采用那种叫做HMAC-SHA256的签名方式来处理, 要是没有通过校验的这些请求, 就会被直接把拒绝掉。
三、核心调用步骤
第一步, 获取Access Token。
请求的方法是POST, 目标是/v2/oauth/token。
参数包括 grant_type, 其数值为 client_credentials, 还有 client_id 也就是 AppKey, 以及 client_secret 也就是 AppSecret。
返回：access_token新网代理域名注册接口，有效期7200秒龙南市就业服务平台，过期后需重新获取。
第二步是要做出提交这种选择, 然后进行注册域名的请求。
这是一个请求, 采用的是POST方法, 路径是/v2/domain/register。
那些必须要传递的参数。
域名: 就是那些还等待去进行注册操作的域名, 它的格式通常类似example.com这种形式。
period：注册年限，取值1至10
nameserver参数是用来指定DNS服务器的信息, 如果没有进行特别传入的话, 那么就会默认地去使用新网那边的DNS服务。
registrar：代理商账号ID
鉴权这个步骤要求在 Header 里面携带 Authorization, 然后冒号后面跟着 Bearer, 接着是一个空格, 最后是 access_token 这个值。
第三步：查询注册结果
发出请求，方法是GET, 路径是/v2/domain/query, 后面还带着参数字符串domain=example.com。
把它注册成一个异步的流程, 提交之后一般在60秒之内完成, 建议采用每隔10秒进行一次轮询的方式, 一直等到它的状态变成“registered”或者“failed”。
四、关键参数与限频规则
五、常见异常与处理
返回结果是401 Unauthorized, 这说明可能是因为Token已经过期了, 或者是签名计算出了错误, 你需要重新去获取新的Token, 并且在操作的时候要仔细检查一下密钥有没有被填写反了。
系统返回了提示, 具体是说状态为409 Conflict, 意思是当前域名被人占了, 你最好换一个新的域名来操作, 或者去查一下这个域名的相关状态, 看它是否在转入冷却期之内。
出现了429 Too Many Requests这个错误, 它表示系统触发限频机制了, 这时候需要按照指数退避的策略来进行重试操作, 初始等待时间是1秒, 最高上限是60秒。
如果出现500系列的服务异常, 那就先记下那个请求ID, 然后再去联系新网的技术支撑人员来排查问题。
六、技术支撑与联调环境
如果在接入的过程中, 碰上了鉴权失败这样的问题, 或者接口返回了不是预期的字段那样的情况, 建议你先去核对一下请求签名生成的逻辑对不对, 然后再拿新网开放平台的最新文档来做对照, 排查那些参数的格式正不正确。有关接口的沙箱测试环境, 你可以通过gz88.cn这个平台在在线进行访问。
这里面支持注册功能的模拟使用, 也支持续费环节的模拟运行, 更支持转入全过程的调用模拟。你不需要进行真实扣费的步骤, 就可以快速地把手头的工作完成, 也就是开发和联调这两方面的验证工作。这样做可以有效降低系统在上线之前的对接风险, 让整个过程更稳妥一些。
