对接必读
一. 接口规范
1.1 接口规则
| 传输方式 | 采用 HTTP、HTTPS |
| 提交方式 | 采用 POST 方法提交 |
| 请求参数类型 | Content-Type: application/json |
| 响应参数类型 | Content-Type: application/json |
| 字符编码 | 统一采用 UTF-8 字符编码 |
| 签名算法 | MD5 （32位） |
| 分页传参 | page、page_size（最大限制100） |
1.2 请求参数公共字段
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| agent_id | 是 | int | 代理ID |
| app_id | 是 | int | 应用ID |
| signid | 是 | string | 签名 |
1.3 返回参数字段格式
注：以下接口均为有返回，返回值放在数据实体 data 里，如无实体值，则以 success 判断结果
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| success | 是 | boolean | 接口调用状态：true成功，false失败 |
| code | 是 | int | 接口调用返回的异常码 |
| message | 是 | string | 接口调用返回的异常消息 |
| data | 是 | string | 接口返回的数据放这里 |
二. 签名算法
2.1 通用签名生成步骤
1. 按照键字母进行正序排序（ASCII 码从小到大排序【字典序】）
2. 排序之后的参数按照 key + value + key + value 格式拼接成字符串stringA（不包含‘+’）
3. 在 stringA 最后拼接上 token 得到 stringSignTemp 字符串，并对 stringSignTemp 进行 MD5 运算，得到 signid
2.2 签名生成示例
// PHP示例
public static function getApiSign($params, $token)
{
unset($params['signid']);
ksort($params);
$str = '';
foreach ($params as $key => $val) {
$str .= $key . $val;
}
return md5($str . $token);
}三. 对接流程
3.1 由芒果方提供agent_id、token、app_id
3.2 接口地址
| 环境 | 生成环境 |
|---|---|
| 生产环境 | https://api-service.mgmovie.net |
| 测试环境 | http://api-dev.mgmovie.net |