抖音获取douyin分享口令url API 返回值说明

742 阅读2分钟

为了进行电商平台API开发,我们需要做下面几件事情。

1)开发者注册一个账号

2)然后在平台应用注册一个应用程序键(App Key) 。

3)下载平台API的SDK并掌握基本的API基础知识和调用

4)利用SDK接口和对象,传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。

5)利用平台提供的API文档中心和测试工具,对接口进行测试。从而了解返回信息,方便程序获取。 以上是电商平台的API应用开发的关键流程,其中通过平台文档中心和API测试工具,进行概念了解和接口信息查询很重要。因为这些数据就是我们需要在逐步显示出来的。lazada 的API很多,不过都分为了好几个领域,慢慢就会了解深入了。

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:word=v.douyin.com/FC9YN33/

参数说明:word:短口令

注册Key申请试用

响应参数

Version: Date:

名称类型必须示例值描述
itemitem[]0视频详情数据

请求示例

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/douyin/item_password/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&word=https://v.douyin.com/FC9YN33/";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

响应示例

{
item: {
item: {
num_iid: "7092264344980868359",
detail_url: "https://www.iesdouyin.com/share/video/7092264344980868359/?region=&mid=7090863251021515533&u_code=0&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&titleType=title",
title: "修以美好,与君相遇#就算无人欣赏也要独自芬芳",
type: "video",
nick: "花草日记 🪴 麦麦",
signature: "🐌不谈悲喜、只闻花香 🐌手机随拍、装点生活",
uid: "5698411035",
short_id: "969898359",
video: {
url: "https://aweme.snssdk.com/aweme/v1/playwm/?video_id=v0200fg10000c9mcherc77ufa73socn0&ratio=720p&line=0",
url_raw: "https://aweme.snssdk.com/aweme/v1/play/?video_id=v0200fg10000c9mcherc77ufa73socn0&ratio=720p&line=0",
pic_url: "https://p6-sign.douyinpic.com/tos-cn-p-0015/871cb3034d9b4073bd2aa8960bff93fd~c5_300x400.jpeg?x-expires=1657267200&x-signature=B51pWtm1i1Mljef8gNaulIXDdgk%3D&from=4257465056_large&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sc=cover&l=202206241655240102080381023402F3ED"
},
music: {
title: "@若然若创作的原声一若然若",
nick: "若然若",
url: "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7090863247943109407.mp3",
pic_url: "https://p6.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_1e7c8177679e3c9b4743da4968714762.jpeg?from=116350172"
},
item_imgs: null
},
data_from: "app"
},
error: "",
reason: "",
error_code: "0000",
cache: 0,
api_info: "today:- max:101000 all[=++];expires:2030-12-31",
execution_time: "2.333",
server_time: "Beijing/2022-06-24 16:55:39",
client_ip: "127.0.0.1",
call_args: [ ],
api_type: "douyin",
server_memory: "3MB",
last_id: false
}

异常示例

{
  "error": "item-not-found",
  "reason": "没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "douyin",
  "request_id": "1ee0ffc041242"}
```
```