PHP对接抖音开发平台接口

article/2025/10/22 19:10:45

  • 一、说明
  • 二、代码
  • 三、代码运行需知
  • 四、功能扩展
  • 五、接口调用需要注意的点
  • 六、接口文档中的 '坑'（以订单列表接口为例）
    • 1、请求参数、响应参数 代表的具体值不清晰
    • 2、页码从第0页开始（这个属于需要注意的点）
    • 3、金额 是元 还是 分，不清晰

一、说明

  • 抖音开放平台-开发指南

二、代码

<?php
namespace app\common\libs;use app\common\exception\BaseException;/*** Class DouYinApi* @package app\common\libs*/
class DouYinApi
{private $host; //抖音接口API，API调用指南：https://op.jinritemai.com/docs/guide-docs/148/814private $appKey; //appKeyprivate $appSecret; //appSecretprivate $accessToken; //访问令牌private $refreshToken; //刷新令牌private $versionNumber; //API协议版本，当前版本为 2private $versionNumberStr; //API协议版本，当前版本为 v2public function __construct(){$this->host = 'https://openapi-fxg.jinritemai.com'; //接口访问地址$this->appKey = '你的抖音后台的appKey';$this->appSecret = '你的抖音后台的appSecret';$this->versionNumber = '2';$this->versionNumberStr = 'v' . $this->versionNumber;//获取access_token,refresh_token放到最后，如果其他的如versionNumber在后面设置则报错："v不可为空"，因为handleToken中调用了versionNumber，但versionNumber此时的值为NULL$result = self::handleToken(); //创建Token
//        $result = self::handleToken(false); //刷新Token：提示-"缺少code"，需要建一张第三方表存抖音该店铺的access_token,refresh_token,expire_time信息$this->accessToken = $result['access_token']; //用于出创建token接口之外的其他接口$this->refreshToken = $result['refresh_token']; //用于刷新token接口}/*** 处理（创建/刷新）Token的方法* 开发指南 > 产品功能 > 授权介绍 -> 自用型应用店铺授权流程：https://op.jinritemai.com/docs/guide-docs/9/21* @param bool $createToken 是否调用创建Token的方法* @return array* @throws BaseException*/public function handleToken($createToken = true){if ($createToken) { //调用创建token接口$param = ['code' => '','grant_type' => 'authorization_self','shop_id' => '你抖音店铺的ID', //店铺ID，仅自用型应用有效；若不传，则默认返回最早授权成功店铺对应的token信息];$method = 'token.create';} else { //调用刷新Token方法$param = [
//                'app_id' => '', //应用key ，长度19位字母和数字组合的字符串，可不传'refresh_token' => $this->refreshToken, //注意：传真实的refreshToken值，而不是传REFRESH_TOKEN'grant_type' => 'refresh_token',];$method = 'token.refresh';}$timestamp = time(); //接口请求前记录开始时间，防止过期时间$expireTime失效$result = self::fetch($method, $param);if ($result['code'] != 10000) { //请求失败throw new BaseException($result['message']);} else {$data = $result['data'];$accessToken = $data['access_token']; //accessToken$refreshToken = $data['refresh_token']; //refreshToken$expireTime = $timestamp + $data['expires_in']; //Token过期时间 = 当前时间 + 有效时间（秒s）return ['access_token' => $accessToken,'refresh_token' => $refreshToken,];}}/*** 封装抖音接口公共方法* PHP调用说明：https://op.jinritemai.com/docs/guide-docs/151/811* @param $method 方法名：格式 token.create 方法中转为 token/create* @param $param 请求接口需要的参数名* @param bool $accessToken url中是否要加上access_token，默认否。*              为什么不直接传accessToken的值：在本类中，可以获取到accessToken的值，直接传，但是如果在其他的地方调用就获取不到access_token的值，需要传true/false标识在本类中获取。* @param bool $paramJsonAddToUrl 是否把paramJson放到 url 中，根据实际情况*          例：实际过程中【订单批量解密接口】不需要放到url中（猜测是这个接口paramJson内容太多，会超出GET的最大内容）*              订单批量解密接口：https://op.jinritemai.com/docs/api-docs/15/982* @return false|mixed|string*/function fetch($method, $param, $accessToken = false, $paramJsonAddToUrl = true){//当前时间戳$timestamp = time();//PHP中：如果数组为空转为json之后是[]。但接口可能是强类型语言编写的，需要传{}。所以$param为空时，需要把$paramJson设置为{}$paramJson = $param ? self::marshal($param) : '{}';//获取签名$sign = self::sign($method, $timestamp, $paramJson);//调用的方法.替换为/$methodPath = str_replace('.', '/', $method);//拼接url路径$url = $this->host . '/' . $methodPath .'?method=' . urlencode($method) .'&app_key=' . urlencode($this->appKey);if ($accessToken) {$url .= '&access_token=' .urlencode($this->accessToken);}$url .= '&timestamp=' . urlencode(strval($timestamp)) .'&v=' . urlencode($this->versionNumber) .'&sign=' . $sign;if ($paramJsonAddToUrl) {$url .= '&param_json=' . $paramJson;}$url .= '&sign_method=' . urlencode('hmac-sha256'); //官方接口为非必填，但是不加签名会验证失败//处理句柄数据$opts = array('http' =>array('method' => 'POST','header' => "Accept: */*\r\n" ."Content-type: application/json;charset=UTF-8\r\n",'content' => $paramJson));$context = stream_context_create($opts);$result = file_get_contents($url, false, $context);return json_decode($result,true);}//计算签名function sign($method, $timestamp, $paramJson){$paramPattern = 'app_key' . $this->appKey . 'method' . $method . 'param_json' . $paramJson . 'timestamp' . $timestamp . $this->versionNumberStr;$signPattern = $this->appSecret . $paramPattern . $this->appSecret;return hash_hmac("sha256", $signPattern, $this->appSecret);}//序列化参数，入参必须为关联数组（键值对数组）function marshal(array $param){self::rec_ksort($param); // 对关联数组中的kv，执行排序，需要递归$s = json_encode($param, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE); // 重新序列化，确保所有key按字典序排序// 加入flag，确保斜杠不被escape，汉字不被escapereturn $s;}//关联数组排序，递归function rec_ksort(array &$arr){$kstring = true;foreach ($arr as $k => &$v) {if (!is_string($k)) {$kstring = false;}if (is_array($v)) {self::rec_ksort($v); //这里的调用方式要和marshal中调用方式一致}}if ($kstring) {ksort($arr);}}
}

三、代码运行需知

  • 在 __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、金额 是元 还是 分，不清晰

  • 不给的话，那就默认为：分
    在这里插入图片描述

http://chatgpt.dhexx.cn/article/4q1FvYGC.shtml

相关文章

PHP api接口开发

PHP api接口开发

本人第一次使用PHP 开发API 1、第一步 开发框架&#xff1a;http://www.thinkphp.cn/down.html 本人下载 :ThinkPHP5.0.24核心版 需要先登陆 下载解压&#xff0c;放入phpstudy 的 网站根目录下&#xff1a;www文件&#xff0c;如下图&#xff1a; phpstudy 选择Apache&am…
阅读更多...
PHP接口加密

PHP接口加密

在工作中PHP接口开发是PHP常见的技术&#xff0c;通过对接口进行一些操作&#xff0c;可以访问接口获取数据&#xff0c;给app/前端提供数据接口等,如果接口没有加密&#xff0c;很容易发生盗用和不安全的操作.下面介绍一下常见的接口加密方法。 一.使用token进行加密解密&…
阅读更多...
php接口开发简单实例

php接口开发简单实例

刚刚写成人生第一个服务器接口&#xff0c;总结分享一下经验&#xff0c;没写过接口的可以看下。 这里以用户用id请求自己个人信息业务为例&#xff1a; <?php $id $_POST["user_id"]; if ($id ! 10086){exit(); }$userinfo array(username>jason,password…
阅读更多...
如何用PHP编写简单的api数据接口

如何用PHP编写简单的api数据接口

点击注册直接获取API数据 一、编写接口所需几样工具或软件&#xff08;均是win764位&#xff09; 1.phpStudy、SQLyog和编码工具&#xff08;sublime text/webStorm/vs code均可&#xff0c;按自己习惯来&#xff09;&#xff1b; 2.安装好phpStudy之后&#xff0c;打开软件…
阅读更多...
PHP开发APP接口实现--基本篇

PHP开发APP接口实现--基本篇

最近一段时间一直在做APP接口&#xff0c;总结一下APP接口开发以来的心得&#xff0c;与大家分享&#xff1a; 1. 客户端/服务器接口请求流程&#xff1a; 安卓/IOS客户端 –> PHP接口 –> 服务器端 –> 数据处理 –> 返回值&#xff08;客户端接收并处理&…
阅读更多...
PHP服务器端API原理及示例讲解(接口开发)

PHP服务器端API原理及示例讲解(接口开发)

直接获取API接口数据的方法点击获取 相信大家都做过PHP请求API接口获取数据&#xff0c;比如淘宝API&#xff0c;微信公众平台&#xff0c;天气查询&#xff0c;快递查询等&#xff0c;有的需要参照接口文档根据签名算法构造sign&#xff08;签名&#xff09;&#xff0c;或者设…
阅读更多...
php开发APP接口（一）

php开发APP接口（一）

php开发APP接口&#xff08;一&#xff09; 使用PHP来生成APP接口数据是非常简单的&#xff0c;如果你还不了解PHP没有关系&#xff0c;只需要看过PHP的基本语法&#xff0c;再看本示例就可以了。 APP接口一般都是json格式&#xff08;当然也有少数xml格式&#xff09;遵循re…
阅读更多...
安卓ViewFlipper跑马灯效果

安卓ViewFlipper跑马灯效果

前言&#xff1a;ViewFlipper是一个切换控件&#xff0c;一般用于图片的切换&#xff0c;当然它是可以添加View的&#xff0c;而不限定只用于ImageView&#xff0c;当然我们也可以自定义View达到跑马灯效果。 效果&#xff1a; ①&#xff1a;MainActivity使用&#xff1a; …
阅读更多...
CSS实现文字跑马灯效果

CSS实现文字跑马灯效果

CSS实现文字跑马灯效果 在完成一个任务的时候&#xff0c;要求在表格中固定宽度的其中一个item文字过长需要滚动显示&#xff0c;然后经过多次效果的尝试&#xff0c;实现代码如下所示&#xff1a; 它需要一个外层包围盒&#xff0c;设置定宽、文字不换行以及超过隐藏子元素为…
阅读更多...
html纵向的跑马灯效果,单行文字垂直/水平跑马灯效果

html纵向的跑马灯效果,单行文字垂直/水平跑马灯效果

需求描述 接到的需求是这样的&#xff1a;跑马灯效果 一次展示一行文字 循环滚动 文字滚动到视野中停留一秒后滚出。 静态效果如下图&#xff0c;文字从下往上或者从右往左滚动&#xff0c;滚动到此位置时停留一秒(不会传动图... 网络上有比较多的多行文字循环滚动的demo,找了一…
阅读更多...
Flutter-跑马灯效果实现

Flutter-跑马灯效果实现

1、背景&#xff1a; 使用三方组件在首页做个跑马灯效果&#xff0c;隔一段时间首页会闪一下&#xff0c;估计是三方组件有内存泄露。趁有空自己写个简单跑马灯效果。 2、效果&#xff1a; 3、调用方法&#xff1a; 将下方代码copy到项目文件内&#xff0c;引用文件&#xff…
阅读更多...
TextView 跑马灯效果

TextView 跑马灯效果

1、重写TextView class TextViewMarquee : AppCompatTextView {constructor(context: Context?) : super(context!!) {}constructor(context: Context?, attrs: AttributeSet?) : super(context!!, attrs) {}constructor(context: Context?, attrs: AttributeSet?, defSt…
阅读更多...
html js 跑马灯效果,Javascript实现跑马灯效果的简单实例

html js 跑马灯效果,Javascript实现跑马灯效果的简单实例

页面html&#xff1a; var speed 10 var demo document.getElementById("demo"); var demo1 document.getElementById("demo1"); var demo2 document.getElementById("demo2"); demo2.innerHTML demo1.innerHTML function Marquee() { if (…
阅读更多...
Vue跑马灯效果

Vue跑马灯效果

1、跑马灯效果 说明&#xff1a;单击"应援"按钮文字向左飘动,再单击"暂停"按钮停止当前飘动 2、完整代码 (注意&#xff1a;代码中需要引入vue.js文件&#xff0c;这个文件自己根据目录位置引入&#xff0c;具体位置代码中有注释) <!DOCTYPE html>…
阅读更多...
跑马灯效果

跑马灯效果

最近做项目需要展示一个展示广告的跑马灯效果&#xff0c;网上找到一个继承 HorizontalScrollView 实现的&#xff0c;但是不能循环滚动&#xff1b;还有用 RecyclerView 实现的&#xff0c;比较好&#xff0c;但是会可以手动滑动&#xff0c;也不符合需求&#xff0c;下面自己…
阅读更多...
android布局跑马灯,Android自定义跑马灯效果（适合任意布局）

android布局跑马灯,Android自定义跑马灯效果（适合任意布局）

因为项目需要&#xff0c;做了一个自定义垂直跑马灯&#xff0c;分享给大家。 先上个效果图&#xff1a; 从图片中可以看到布局是由包含两个TextView的布局组成&#xff0c;一般的垂直跑马灯效果只支持单个TextView&#xff0c;水平方向的跑马灯更是不需要自定义&#xff0c;原…
阅读更多...
android跑马灯效果不起作用,Android跑马灯效果失效问题

android跑马灯效果不起作用,Android跑马灯效果失效问题

Android中的跑马灯效果在特定情况下用的效果很不错&#xff0c;调试的时候发现在2.3系统下&#xff0c;文字跑动正常&#xff0c;后来无意换了另一个手机&#xff0c;4.0以上的系统&#xff0c;发现文字跑动效果失效&#xff0c;研究后发现有两种情况会导致失效。 先看跑马灯效…
阅读更多...
Unity 跑马灯效果

Unity 跑马灯效果

一、效果 二、需要动画插件DOTween 三、脚本 1.每个格子上的脚本文件 using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.UI; using DG.Tweening; public class MarqueeUIItem : MonoBehaviour {private RawImage m_RawImag…
阅读更多...
Android TextView设置跑马灯效果

Android TextView设置跑马灯效果

【前言】 在Textview设置的宽度有限&#xff0c;而需要显示的文字又比较多的情况下&#xff0c;往往需要给Textview设置跑马灯效果才能让用户完整地看到所有设置的文字&#xff0c;所以给TextView设置跑马灯效果的需求是很常见的 一、新手设置跑马灯效果 1、先在xml中给Textvi…
阅读更多...
css 实现跑马灯效果

css 实现跑马灯效果

最近有一个跑马灯的效果&#xff0c;需要实现。本来想偷个懒从网上随便拷贝一个&#xff0c;结果发现都不太理想&#xff0c;于是自己动手封装了一个&#xff0c;和大家分享一下。 首先我们要知道跑马灯的具体效果是什么样子的。 效果图 我们通过效果图可以看到&#xff0c;在…
阅读更多...
推荐文章

Copyright @ 2022~2023