CMCC.IN开放数据接口开发指南

说明：本开发指南适用于开发者，依据本文档，可以使用多种语言对接口进行开发

cmcc.in的开放平台请求地址为 http://cmcc.in/open.api

该接口使用国际规范的REST通用接口，这是一个提供开放数据分享暨对接平台。通过该平台，广大站长和开发者可以提交结构化的数据或资源，可以第三方接入我方提供的服务

接口请求支持的方式：POST,GET

第三方应用在递交请求的时候，为了确保应用与API 服务器之间的安全通信，防止Secret Key盗用，数据篡改等恶意攻击，API 服务器使用了签名机制（即sig参数）来认证应用。签名是由请求参数和应用的私钥Secret Key经过MD5加密后生成的字符串。应用在调用API之前，要计算出签名，并追加到请求参数中。

目前官方只开放了接口的一个请求方法：add

该方法需要递交如下参数：

api_key,url

其中的url必须经过网址编码！

以下以get方式为例，递交请求

首先递交第一个参数：请求方法 method=add

而后递交第二个参数api_key：请求方法:api_key=xxxxxxxxxx

然后递交第三个参数url:请求方法 url=yyyyyyyyyyyyyyyy

最后计算数字签名：

算法如下

首先把上述的3个参数按照给定的顺序以key=value的方式连接成一个字符串，然后在连接上secret_key

得到一个字符串，然后对这个字符串进行md5校验，得到的md5值为sig值

将sig值附加到请求的最后，完成一个请求

假设得到的md5值为：66f332c08191b8a5dd3477d36f3af49f

最终的请求地址为

http://cmcc.in/open.api?method=add&api_key=xxxxxxxxxx&url=yyyyyyyyyyyyyyyyy&sig=66f332c08191b8a5dd3477d36f3af49f



请求返回结果组成部分为 状态码：结果

请求成功状态码为success,失败则为error

以下为error的错误代码

0 ： 未知的请求方法

1 ： 递交的参数不全

2 ： api_key无效

3 ： 该api_key 被停用

4 ： 签名sig值错误

5 ： 请求执行失败，请重新发起请求



附：如果确保算法无误的情况下持续出现4号错误（即使使用官方sdk也是如此），请登陆会员中心重新初始化帐号获取新的密钥再尝试（该概率小于一百亿分之一）