PHP对接抖音开发平台接口的详细教程

目录
  • 一、说明
  • 二、代码
  • 三、代码运行需知
  • 四、功能扩展
  • 五、接口调用需要注意的点
  • 六、接口文档中的 ‘坑'(以订单列表接口为例)
    • 1、请求参数、响应参数 代表的具体值不清晰

一、说明

抖音开放平台-开发指南

二、代码


<?PHP
namespace app\common\libs;

use app\common\exception\BaseException;


class DouYinapi
{
    private $host; //抖音接口API,API调用指南:https://op.jinritemai.com/docs/guide-docs/148/814
    private $appKey; //appKey
    private $appSecret; //appSecret
    private $accessToken; //访问令牌
    private $refreshToken; //刷新令牌
    private $versionNumber; //API协议版本,当前版本为 2
    private $versionNumberStr; //API协议版本,当前版本为 v2

    public 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接口
    }

    
    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,
            ];
        }
    }

    
    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,汉字不被escape
        return $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用于接口调用

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

param为空的问题:param为空,$paramJson字符串的值为 {},而不是 []

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

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

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

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

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

在这里插入图片描述

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

在这里插入图片描述

页码从第0页开始(这个属于需要注意的点)

在这里插入图片描述

金额 是元 还是 分,不清晰

不给的话,那就默认为:

在这里插入图片描述

到此这篇关于PHP对接抖音开发平台接口的详细教程的文章就介绍到这了,更多相关PHP 抖音开发平台接口内容请搜索编程界以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程界!

--结束END--

本文标题: PHP对接抖音开发平台接口的详细教程

本文链接: https://www.lsjlt.com/news/45.html (转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

猜你喜欢

  • PHP对接抖音开发平台接口的详细教程

    目录一、说明二、代码三、代码运行需知 四、功能扩展五、接口调用需要注意的点六、接口文档中的 ‘坑'(以订单列表接口为例)1、请求参数、响应参数 代表的具体值不清晰一、说明抖音开放平台-开发指南二、代码phpnamespace app\common\libs;
  • java对接支付宝支付接口开发详细步骤

    本文主要介绍了java对接支付宝支付接口开发详细步骤,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
  • java开发平台有哪些

    java的开发平台有:1.Jbuilder,java可视化开发工具;2.Eclipse,基于java的可扩展开发平台;3.NetBeans,开放框架的、可扩展的开发平台;java的开发平台有以下几种1.JbuilderJbuilder是一个
    阅读数:603 Java
  • 推荐一款快速开发平台,web中最好的快速开发平台

    力软快速开发平台是力软自主开发的基于SOA面向服务的应用系统开发平台,可以方便快捷的搭建企业、医院、工厂、学校等行业的企业级运营管理平台。平台采用.net.技术架构,webapi服务搭建。力软快速开发平台的主要优势是一个成熟的集成快速开发平
    阅读数:661 web 中最 好的
  • Android仿抖音APP

    国庆放假,自己撸的App 模仿抖音写的App,实现了类似抖音的部分功能。即使聊天部分还没有写完,抽空写完,开源功能简单,为提高代码的复用性,采用封装---效果图开发环境开发工具 Android studio 3.4架构  mvp技术
    阅读数:650 app Android
  • windows 8 开发之开发平台与开发框架的应用

    windows 8 开发之开发平台与开发框架的应用win8 App开发主要分成两部分,desktop app和metro app。右边蓝色的部分就是desktop app的部分,也是从win7延续过来没有发生变动的部分,前段在论坛上经常看到
    阅读数:130 框架 平台 windows
  • 什么是低代码开发平台

    这篇文章主要讲解了“什么是低代码开发平台”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“什么是低代码开发平台”吧!低代码开发平台是什么:在低代码平台,技术人员和业务专业人员可通过图形界面(而不
    阅读数:338 低代码
  • Flutter实现抖音点赞效果

    抖音的点赞效果在第一次看到的时候,总有一种眼前一亮的感觉。一边看视频,还能在视频上点赞,而且整个屏幕都能够点赞,并伴随动画,还是很炫酷的。今天我们用Flutter来实现一下这个效果
  • java开发语言的软件开发平台有哪些

    Eclipse :Eclipse 是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。幸运的是,Eclipse 附带了一个标准的插件集,包括Java开发工具(Java Development
    阅读数:122 java入门 java
  • 快速开发平台正逐步取代传统开发模式

    互连网的出现改变了人们的某些生活方式,而随着互连网的普及,越来越多的企业准备或已经要把过去传统的应用系统模式转移到互连网上来,这样的转移将极大地减少企业因维护庞大的分布式的应用系统而耗费的人力、财力和物力。传统的应用系统开发方法(面向过程、
    阅读数:427 传统 模式 取代
  • 选择软件开发平台,“快速开发”是关键

    一、快速开发平台传统代码级开发成本越来越高,软件的功能升级跟不上市场的变化,客户的满意度越来越低。造这方面的原因是多方面,最重要是人力成本大幅上升和企业对软件的要求越来越高,通用的软件产品已无法满足企业对管理的要求,通用一款软件产品只能解
    阅读数:271 关键 选择 开发平台
  • iOS实现抖音点赞动画效果

    本文实例为大家分享了iOS实现抖音点赞动画的具体代码,供大家参考,具体内容如下1. 概述最近看到抖音点赞爱心的动画效果比较好,出于好奇,自己也研究仿照动画效果写了一个,不喜欢的朋友可不要喷我噢!!!话不多说,先来看一下执行效果。2.
    阅读数:748 iOS 抖音 点赞
  • Android仿抖音上下滑动布局

    抖音上下滑动,监听播放,自动吸顶,吸底效果,供大家参考,具体内容如下使用RecyclerView+PagerSnapHelper实现public class DouYinLayoutManager extends LinearLayout
    阅读数:210 布局 抖音 Android
  • Python 抖音评论数据抓取分析

    大家好,最近抖音张同学突然火了,两个月涨粉一千多万。今天这篇文章,我抓取了张同学的视频的评论数据,想从文本分析的角度,挖掘一下大家对张同学感兴趣的点
  • 度量快速开发平台:如何实现字段别名效果

    方法一:(sql设置法)打开窗体业务表编辑界面例如:现在需要将委托单位显示为建设单位,那么根据sql语句的别名命名法则,我们在需要设置别名字段后写上“原名 AS 别名”即可。方法二:(平台设置法)在度量开发平台中,我们集成提供了一套完善方法
    阅读数:683 sql 语句 开发平台
  • Spring Boot + Thymeleaf + Activiti 快速开发平台项目 附源码

    这篇文章主要介绍了Spring Boot + Thymeleaf + Activiti 快速开发平台项目附源码,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
  • Python实现自动化刷抖音的实例

    前言都说抖音有毒,一刷就停不下来了。看来抖音这款产品紧紧抓住了人们内心深处的某些需求。当然今天不是来探讨抖音这款产品的啊。今天我们来学习如何用Python实现自动刷抖音,并为颜值高的的小哥哥小姐姐点赞并评论。项目环境语言:Python3
  • 抖音很火的vbs表白代码(简单实用!)

    这篇文章主要给大家介绍了关于抖音很火的vbs表白代码的相关资料,教你用vbs表白女朋友,包含多个弹窗绝对实在,保管实用,内容可以自己修改,需要的朋友可以参考下
  • 抖音怎么设置小程序通知页面

    抖音设置小程序通知的方法:1.进入抖音app界面,选中底部的“我”;2.点击页面右上角的三横线图标,进入“设置”;3.在设置中选择“通知设置”4.开启“接受推送通知”;5.最后,选择是否开启“私信应用外提醒”即可。
    阅读数:298 小程序
  • Android自定义videoview仿抖音界面

    这篇文章主要为大家详细介绍了Android自定义videoview仿抖音界面,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    阅读数:808 Android videoview 抖音