流量充值API
1 协议说明
| 协议 | HTTP POST |
|---|---|
| 编码格式 | UTF8 |
| URL | 举例：http://msg.yundashi.com/cdp/intf/charge?sdkappid=xxxxx&random=xxxx |
| 接口说明 | 给用户手机号码充值流量注：sdkappid请填写您在云大师短信官网上申请到的客户编号，random请填成随机数。 |
2 请求包体
包体为json字符串，参数如下：
{
"sig": "40834f0be1684ce9b5ff85c923a7bf74dc3b3f1b2d085f00ae336a9c56118fe3", //app凭证，具体计算方式见下注
"time": 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
"mobile": "13788888888", //手机号码
"grade": 10, //充值档位,单位M。
"is_province": 0, //是否分省，默认为0
"reason": "充值原因" ,//备注信息，可选填写
"orderid": "appid_xxxx" //可选填写，如果填写请保证唯一性，建议：appid_xxxx格式
}
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| mobile | 是 | string | 手机号 |
| grade | 是 | number | 充值档位,单位M。 |
| is_province | 是 | number | 是否分省，默认为0 |
| reason | 否 | string | 备注信息，可选填写 |
| sig | 是 | string | App 凭证，具体计算方式见下注 |
| time | 是 | number | 请求发起时间，unix 时间戳（单位：秒），如果和系统时间相差超过 10 分钟则会返回失败 |
注：
"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile&grade=$grad)生成 伪代码如下：
string strMobile = "13788888888"; //mobile字段的内容
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey，需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
int grade = 10; //M
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile&grade=$grade);
3 应答包体
{
"RequestId": "85795663-8021", //如果用户提供orderid，则是orderid，如果用户没有提供，则系统返回orderid。该ID用于查询订单充值情况
"Code": "OK", //状态码-返回OK代表请求成功,其他错误码见状态码描述
"Message": "xxxxxxx", ///状态码描述
}