本文主要介绍了PHP对接抖音开发平台接口的详细教程，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下。

一、说明

抖音开放平台-开发指南

二、代码

1. <?php 
2. namespace app\common\libs; 
3.  
4. use app\common\exception\BaseException; 
5.  
6. /** 
7.  * Class DouYinApi 
8.  * @package app\common\libs 
9.  */ 
10. class DouYinApi 
11. { 
12.     private $host; //抖音接口API，API调用指南：https://op.jinritemai.com/docs/guide-docs/148/814 
13.     private $appKey; //appKey 
14.     private $appSecret; //appSecret 
15.     private $accessToken; //访问令牌 
16.     private $refreshToken; //刷新令牌 
17.     private $versionNumber; //API协议版本，当前版本为 2 
18.     private $versionNumberStr; //API协议版本，当前版本为 v2 
19.  
20.     public function __construct() 
21.     { 
22.         $this->host = 'https://openapi-fxg.jinritemai.com'; //接口访问地址 
23.         $this->appKey = '你的抖音后台的appKey'; 
24.         $this->appSecret = '你的抖音后台的appSecret'; 
25.  
26.         $this->versionNumber = '2'; 
27.         $this->versionNumberStr = 'v' . $this->versionNumber; 
28.  
29.         //获取access_token,refresh_token放到最后，如果其他的如versionNumber在后面设置则报错："v不可为空"，因为handleToken中调用了versionNumber，但versionNumber此时的值为NULL 
30.         $result = self::handleToken(); //创建Token 
31. //        $result = self::handleToken(false); //刷新Token：提示-"缺少code"，需要建一张第三方表存抖音该店铺的access_token,refresh_token,expire_time信息 
32.         $this->accessToken = $result['access_token']; //用于出创建token接口之外的其他接口 
33.         $this->refreshToken = $result['refresh_token']; //用于刷新token接口 
34.     } 
35.  
36.     /** 
37.      * 处理（创建/刷新）Token的方法 
38.      * 开发指南 > 产品功能 > 授权介绍 -> 自用型应用店铺授权流程：https://op.jinritemai.com/docs/guide-docs/9/21 
39.      * @param bool $createToken 是否调用创建Token的方法 
40.      * @return array 
41.      * @throws BaseException 
42.      */ 
43.     public function handleToken($createToken = true) 
44.     { 
45.         if ($createToken) { //调用创建token接口 
46.             $param = [ 
47.                 'code' => '', 
48.                 'grant_type' => 'authorization_self', 
49.                 'shop_id' => '你抖音店铺的ID', //店铺ID，仅自用型应用有效；若不传，则默认返回最早授权成功店铺对应的token信息 
50.             ]; 
51.             $method = 'token.create'; 
52.  
53.         } else { //调用刷新Token方法 
54.             $param = [ 
55. //                'app_id' => '', //应用key ，长度19位字母和数字组合的字符串，可不传 
56.                 'refresh_token' => $this->refreshToken, //注意：传真实的refreshToken值，而不是传REFRESH_TOKEN 
57.                 'grant_type' => 'refresh_token', 
58.             ]; 
59.             $method = 'token.refresh'; 
60.         } 
61.  
62.         $timestamp = time(); //接口请求前记录开始时间，防止过期时间$expireTime失效 
63.         $result = self::fetch($method, $param); 
64.         if ($result['code'] != 10000) { //请求失败 
65.             throw new BaseException($result['message']); 
66.         } else { 
67.             $data = $result['data']; 
68.             $accessToken = $data['access_token']; //accessToken 
69.             $refreshToken = $data['refresh_token']; //refreshToken 
70.             $expireTime = $timestamp + $data['expires_in']; //Token过期时间 = 当前时间 + 有效时间（秒s） 
71.  
72.             return [ 
73.                 'access_token' => $accessToken, 
74.                 'refresh_token' => $refreshToken, 
75.             ]; 
76.         } 
77.     } 
78.  
79.     /** 
80.      * 封装抖音接口公共方法 
81.      * PHP调用说明：https://op.jinritemai.com/docs/guide-docs/151/811 
82.      * @param $method 方法名：格式 token.create 方法中转为 token/create 
83.      * @param $param 请求接口需要的参数名 
84.      * @param bool $accessToken url中是否要加上access_token，默认否。 
85.      *              为什么不直接传accessToken的值：在本类中，可以获取到accessToken的值，直接传，但是如果在其他的地方调用就获取不到access_token的值，需要传true/false标识在本类中获取。 
86.      * @param bool $paramJsonAddToUrl 是否把paramJson放到 url 中，根据实际情况 
87.      *          例：实际过程中【订单批量解密接口】不需要放到url中（猜测是这个接口paramJson内容太多，会超出GET的最大内容） 
88.      *              订单批量解密接口：https://op.jinritemai.com/docs/api-docs/15/982 
89.      * @return false|mixed|string 
90.      */ 
91.     function fetch($method, $param, $accessToken = false, $paramJsonAddToUrl = true) 
92.     { 
93.         //当前时间戳 
94.         $timestamp = time(); 
95.  
96.         //PHP中：如果数组为空转为json之后是[]。但接口可能是强类型语言编写的，需要传{}。所以$param为空时，需要把$paramJson设置为{} 
97.         $paramJson = $param ? self::marshal($param) : '{}'; 
98.  
99.         //获取签名 
100.         $sign = self::sign($method, $timestamp, $paramJson); 
101.  
102.         //调用的方法.替换为/ 
103.         $methodPath = str_replace('.', '/', $method); 
104.  
105.         //拼接url路径 
106.         $url = $this->host . '/' . $methodPath . 
107.             '?method=' . urlencode($method) . 
108.             '&app_key=' . urlencode($this->appKey); 
109.  
110.         if ($accessToken) { 
111.             $url .= '&access_token=' .urlencode($this->accessToken); 
112.         } 
113.  
114.         $url .= '&timestamp=' . urlencode(strval($timestamp)) . 
115.             '&v=' . urlencode($this->versionNumber) . 
116.             '&sign=' . $sign; 
117.  
118.         if ($paramJsonAddToUrl) { 
119.             $url .= '&param_json=' . $paramJson; 
120.         } 
121.  
122.         $url .= '&sign_method=' . urlencode('hmac-sha256'); //官方接口为非必填，但是不加签名会验证失败 
123.  
124.         //处理句柄数据 
125.         $opts = array('http' => 
126.             array( 
127.                 'method' => 'POST', 
128.                 'header' => "Accept: */*\r\n" . 
129.                     "Content-type: application/json;charset=UTF-8\r\n", 
130.                 'content' => $paramJson 
131.             ) 
132.         ); 
133.  
134.         $context = stream_context_create($opts); 
135.         $result = file_get_contents($url, false, $context); 
136.  
137.         return json_decode($result,true); 
138.     } 
139.  
140.     //计算签名 
141.     function sign($method, $timestamp, $paramJson) 
142.     { 
143.         $paramPattern = 'app_key' . $this->appKey . 'method' . $method . 'param_json' . $paramJson . 'timestamp' . $timestamp . $this->versionNumberStr; 
144.         $signPattern = $this->appSecret . $paramPattern . $this->appSecret; 
145.  
146.         return hash_hmac("sha256", $signPattern, $this->appSecret); 
147.     } 
148.  
149.     //序列化参数，入参必须为关联数组（键值对数组） 
150.     function marshal(array $param) 
151.     { 
152.         self::rec_ksort($param); // 对关联数组中的kv，执行排序，需要递归 
153.         $s = json_encode($param, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE); // 重新序列化，确保所有key按字典序排序 
154.         // 加入flag，确保斜杠不被escape，汉字不被escape 
155.         return $s; 
156.     } 
157.  
158.     //关联数组排序，递归 
159.     function rec_ksort(array &$arr) 
160.     { 
161.         $kstring = true; 
162.         foreach ($arr as $k => &$v) { 
163.             if (!is_string($k)) { 
164.                 $kstring = false; 
165.             } 
166.             if (is_array($v)) { 
167.                 self::rec_ksort($v); //这里的调用方式要和marshal中调用方式一致 
168.             } 
169.         } 
170.         if ($kstring) { 
171.             ksort($arr); 
172.         } 
173.     } 
174. } 

三、代码运行需知

在 __construct() 方法 $this->appKey 中加上你的真实appKey

在 __construct() 方法 $this->appSecret 中加上你的真实appSecret

在 handleToken() 方法 shop_id 中加上你真实的抖音店铺ID

四、功能扩展

加一张数据表 third_shop（第三方店铺表）：存放第三方店铺（比如：抖音）的信息，表的字段大致有：id；shop_name：店铺名；third_shop_id：第三方店铺的ID，source：店铺来源（抖音，京东，天猫）；app_key，app_secret，access_token，refresh_token，expire_time：过期时间；status：状态（0-关闭；1-启用），create_time，update_time ...

我们要对接抖音前，在third_shop中写好 id；shop_name：店铺名；third_shop_id：第三方店铺的ID，source：店铺来源（抖音，京东，天猫）；app_key，app_secret；status：状态（0-关闭；1-启用），create_time，update_time ....

在 __construct()中先查询店铺的信息，如果 access_token为空 或者 expire_time过期时间 小于 当前时间，则需要重新生成 access_token，refresh_token，expire_time：过期时间 在 handleToken() 中加上third_shop 表更新操作；否则取数据表中未过期的 access_token，refresh_token用于接口调用

五、接口调用需要注意的点

1、param为空的问题：param为空，$paramJson字符串的值为 {}，而不是 []

2、rec_ksort递归调用的问题：rec_ksort中调用rec_ksort方式要和marshal中调用rec_ksort方式一致

3、paramJson何时传的问题：如果接口请求数据太大，GET请求可能会超出最大值，则 fetch() 中 $paramJsonAddToUrl 可试着传 false

六、接口文档中的 ‘坑'（以订单列表接口为例）

1、请求参数、响应参数 代表的具体值不清晰

订单列表中 请求参数、响应参数 main_status，每个数字代表什么意思，没有清楚的给出，如下图：

给了，在订单详情 接口的 响应参数 中，如下图：

2、页码从第0页开始（这个属于需要注意的点）

3、金额 是元 还是 分，不清晰

不给的话，那就默认为：分

Tags: PHP对接抖音开发平台接口

分享到：