文档转图片基础接口调用

2023-06-01 11:21:41    接口动态   

1. 接口调用

所有接口调用根路径为 http://api.tecmz.com/open_api/ ,调用方式为 POST 。

2. 请求公共参数

参数错误说明
app_idAppId
timestamp时间戳,从1970年01月01日到现在的秒数,误差不超过1800秒
sign请求签名,计算方式见 签名生成方法

3. 签名生成方法

1) 对参数按照key=value的格式,并按照参数名ASCII字典序排序如下:

param="app_id=xxxxxxxxxx&body=test&timestamp=1365773829";

2) 拼接API密钥:

paramWithSecret=stringA+"&app_secret=xxxxxxxxxxxxxx"
sign=md5(paramWithSecret)

3) 拼接上签名

param=param+"&sign="+sign

示例代码

PHP
<?phpfunction common($params, $appSecret, $function = 'urlencode'){
    ksort($params, SORT_STRING);

    $str = [];
    foreach ($params as $k => $v) {
        $str [] = $k . '=' . $function($v);
    }

    $str[] = 'app_secret=' . $appSecret;
    $str = join('&', $str);

    $sign = md5($str);

    return $sign;}

4. 统一返回封装

调用成功

{
  "code": 0,
  "msg": "ok",
  "data": {
    "xxx": "xxx"
  }}

其中 data 中为业务数据

调用失败

{
  "code": "<错误码>",
  "msg": "<错误原因>"}

5. 错误码

错误码错误说明
0业务处理成功
-1业务处理出现错误


QQ
微信
公众号