开发说明

请详细阅读文档，相关秘钥信息需对接商务人员获取

接口信息

正式环境地址为：https://api.yinglexing.com/
请求方式：POST
Content-Type：application/x-www-form-urlencoded
所有接口均需要签名, 详情查阅下方（基本参数及校验）

基本参数及校验

公共 Body 请求参数

参数名	示例值	类型	是否必须	描述说明	公共
app_id	16624661113	String	是	app_id	是
sign	D50F19FD31276B0414667C061AF625C3	String	是	签名（详见“签名规则”）	是
time	1776250548	Integer	是	当前10位时间戳	是

秘钥信息

app_id 和 app_secret，请联系商务人员获取

签名规则

1、除sign以外，将所有参数按照键名排序，php-demo如下：

$params = [
	'app_id' => '13000000000',
	'sign' => '370B282C413E6EB3C83D1A20A02AEDA0',
	'time' => 1693811486,
	'medium_id' => 'abc123456',
	'medium_name' => '测试'
];
$params = ksort($params);

2、遍历数组，将参数的key与value用=连接，得到字符串。再将所有得到的字符串用&连接，得到新字符串。以上述例子，得到的字符串为

$str = 'app_id=13000000000&medium_id=abc123456&medium_name=测试&time=1693811486';

3、将生成后的字符串同样与app_secret拼接，php-demo 如下：

$app_secret = '789';
$str .= "&app_secret=789";
//$str = 'app_id=13000000000&medium_id=abc123456&medium_name=测试&time=1693811486&app_secret=789';

4、将字符串进行md5加密转大写，得到签名sign

$sign = md5($str);
$sign = strtoupper($sign);

PHP签名方法

其他语言请参考实现

/**
 * 获取签名 getSign
 * @param array $params 参与签名的参数
 * @param sring appSecret app_secret
 * @return sring 签名
*/
function getSign($params = [] , $appSecret)
{
    ksort($params);
    $string = [];
    foreach ($params as $key => $value) {
        $string[] = $key . '=' . $value;
    }
    $str = implode('&', $string);
    $str = $str."&app_secret=" . $appSecret;
    $sign = md5($str);
    return strtoupper($sign);
}

公共返回

公共返回参数

参数名	类型	是否必须	描述说明
code	Integer	是	状态码
msg	String	是	返回文字信息
time	Integer	是	当前时间戳
data	data	String/Array/Object	返回的数据

状态码

状态码	含义
200	成功
400	失败（详见公共返回参数“msg”参数值）
402	账号信息有误
403	账号已被禁
404	签名错误