抖音核心协议的步骤是：
1、在查询串插入一个固定的键rstr
2、对查询串进行按键排序并取值，对空格和+进行转义为a
3、然后取MD5；如果时间轴&1为1，那么取多一次MD5
4、将MD5结果分别和5******6、1******4进行2次错位排序算法
5、将4的结果再进行一次错位排序，得到26位字符
6、将字符分别取18位给到as和cp字段，追加到查询串最后
设备注册激活（第二步）
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/device/register
- Content-Type：multipart/form-data
- A***ess-Token: 应用授权接口返回的值
- 认证方式：无需认证
参数：
参数名 必选 类型 说明
无
返回数据：
参数名 类型 说明
code int 0成功，-1失败 1-提示消息
msg string 反馈信息
data json 需要至少本地保存 device_id
此接口调用一次即可，Token认证信息永不失效。~
请求参数示例
{
}
"code": 0,
"data": {
"ip": "",
"proxies": {
"http": "socks5://xxx:1",
"https": "socks5://xx:1"
},
"version_name": "19.4.0",
"version_code": 190400,
"manifest_version_code": 190401,
"update_version_code": 19409900,
"gen_time": "2022-05-13 16:55:33",
"_gen_time": 1652432133000,
"start_time": 1652431173.854993,
"start_time_ts": 1652431173,
"start_time_tk": 1652431173854,
"apk_first_install_time": 1649361333000,
"first_install_time": 1652432136,
"verify_ticket": "",
"data_user_ts_double": 3212929610,
"apk_install_path": "/data/app/***.ss.android.ugc.aweme-KRvkbnv67JCWUoF6CPGZ+Q==/base.apk",
"v56_ts": 3212927894,
"sdi_v12_uuid": "53f3d168-fb68-4660-884e-4502f8dc9c2e",
"ri_uuid": "07f4a478-aa53-4e06-b2d4-bbab3f86cdfe",
"sdi_token_first": "x..",
"sdi_token_second": "x",
"act_token": "",
"act_base": "",
"act_data": "",
"device_platform": "android",
"device_brand": "google",
"device_type": "google",
"os_version": "9",
"os_api": 28,
"channel": "wandoujia_lesi_1128_1108",
"user_agent": "***.ss.android.ugc.aweme/xxx (Linux; U; Android 9; zh_***; xxxx; Build/PQ3A.190801.002; Cro***/TT***Version:28eaf52b 2021-12-28 QuicVersion:xxx 2021-08-12)",
"language": "zh-Hans-***",
"language2": "zh-Hans_***",
"region": "***",
"app_language": "zh",
"app_name": "aweme",
"app_version": "19.4.0",
"display_name": "抖音",
"package": "***.ss.android.ugc.aweme",
"aid": "1128",
"ac": "WIFI",
"language_region": "zh_***",
"tz_name": "Asia/Shanghai",
"tz_offset": 28800,
"timezone": 8,
"resolution_width": "1440",
"resolution_height": "2621",
"resolution": "1440x2621",
"display": "1440x2621",
"m***_mnc": "46011",
"dpi": "560",
"device_id": "xxx",
"install_id": "xx",
"device_token": "xxx",
"clientudid": "b606ea0b-dc80-40d5-926c-04bea5347d2f",
"openudid": "xxx",
"cdid": "xxx",
"oaid": "xx",
"uuid_str": "xxx",
"device_unique_key": "x+8nPfPdrELhlqun0gc08=",
"cookie_str": "",
"cookie_js": {},
"room_id": "",
"mac_address": "55:11:0f:1e:30:5b",
"sdk_version": "3.6.0-rc.6.1-bugfix",
"passport_sdk_version": "20356",
"default_time_out_time": 20,
"internal_ext": "",
"cursor": "",
"req_ip": "192.168.1.42",
"build_serial": "8c02b173",
"serial_number": "8c02b173",
"req_id": "xx",
"iv": "a7afb24947a649d0",
"key": "xx",
"rom": "5670241",
"rom_version": "PQ3A.190801.002",
"session_key": "",
"a***ount": null,
"a***ount_activate": "",
},
"msg": "设备注册成功."
}
错误返回示例
"msg": "调用失败",
"code": -1,
"data": null
}
获取登陆二维码（第一步）
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/login/loginqr
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string wcid
client_ip 是 string 客户那边的Ip一定要填，为了设置跟客户同一个地方，否则会异地风控
返回数据：
参数名 类型 说明
code string 0成功，!0失败
msg string 反馈信息
data
expire string 超时时间，一般一分钟
qr_data string 二维码base64格式
wcid string 新的wcid，如果登陆成功，开发者用此wcid 需要保存
请求参数示例
{
"wcid": "13536266035312762881"
}
成功返回示例
{
"code": 0,
"data": {
"expire": "2022-05-31 10:45:30",
"qr_data": "data:image/png;base64,iVB..",
"qrcode_index_url": "https://aweme.snssdk.***/passport/web/scan_index/?hide_nav_bar=1&next_url=https%3A%2F%2Faweme.snssdk.***%2Fpassport%2Fmobile%2Fscan_qrcode%2F&qr_source_aid=1128&source_extra=pad&token=e93eeecd3450cbf5889693cbe***9de6d_hl",
"uuid": "e93eeecd3450cbf5889693cbe***9de6d_hl",
"wcid": "1553421291250257920"
},
"msg": "su***ess"
}
错误返回示例
code 非0
{
"msg": "调用失败",
"code": -1,
"data": null
}
执行登陆（第二步）
登陆成功后， 返回的数据跟 手机验证码 一样
该接口是阻塞的； 调用时候超时设置1分钟； 抖音扫码1分钟内客户需要扫码
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/login/loginqr
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 获取二维码返回的wcid
返回数据：
参数名 类型 说明
code string 0成功，!0失败
msg string 反馈信息
data
user_id 整型 user_id
user_id_str 字符串 user_id_str
sec_user_id 字符串 sec_user_id
name 字符串 昵称
avatar_url 字符串 头像
… … …
请求参数示例
{
"wcid": "1353626603531276288"
}
成功返回示例
正确返回数据
{
"code": 0,
"data": {
"id": "0",
"robot_type": "",
"create_time": 1659518629,
"remark": "",
"enabled": 0,
"robot_name": "",
"status": "",
"s_a***id": "11111111111",
"s_nickname": "用户xxxxx",
"s_state": "2",
"s_device": "Pixel 3 XL",
"s_headurl": "https://p9-passport.bytea***timg.***/img/mosaic-legacy/3793/3114521287~120x256.image",
"s_mobile": "178******11",
"s_email": "",
"s_alias": "MS4wLjABAAAAMHYc4Rf_7nb-JdMBWSQ3yKfvCMxF4zlMmcR2QnqwKLc",
"s_data62": "",
"s_username": "",
"s_password": "",
"src_type": 0,
"wcid": "155475963926492364x",
"app_id": "152392381778782208x",
"member_id": 152391164527169130x,
"device_id": "192242149649226x",
"install_id": "",
"device_id_out": ""
},
"msg": "su***ess"
}
错误返回示例
code 非0
{
"msg": "调用失败",
"code": -1,
"data": null
}
发送文本消息
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/msg/txt_msg
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 微信实例ID
to_wx_id 是 string 接收人抖音号 uid
content 是 string 文本内容消息息
返回数据：
```
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
请求参数示例
{
"content": "string",
"to_wx_id": "string",
"wcid": "string"
}
成功返回示例
{
"msg": "发送成功",
"code": 0,
"data": null
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
综合搜索
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/aweme/search_general
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
keyword 是 String 搜索词
page_index 否 int 第几页
page_size 否 int 默认设置0
请求参数示例
{
"keyword": "姚明",
"page_index": 1,
"page_size": 10,
"wcid": "1524670718678142971"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":[
{},{}]
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
搜索视频
注意：
- 通过关键字搜索视频， 切换到视频页的查询数据
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/aweme/search_video
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
keyword 是 String 搜索词
page_size 否 int 第几页
请求参数示例
{
"keyword": "姚明",
"page_index": 1,
"page_size": 10,
"wcid": "1524670718678142971"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":[
{},{}]
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
搜索直播
- 通过关键字搜索视频， 切换到视频页的查询数据
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/aweme/search_live
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
keyword 是 String 搜索词
page_size 否 int 第几页
请求参数示例
{
"keyword": "姚明",
"page_index": 1,
"page_size": 10,
"wcid": "1524670718678142971"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":[
{},{}]
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
搜索用户
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/aweme/search_user
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
keyword 是 String 搜索词
page_size 否 int 第几页
请求参数示例
{
"keyword": "姚明",
"page_index": 1,
"page_size": 10,
"wcid": "1524670718678142971"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":[
{},{}]
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
搜索评论
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/aweme/search_***ment
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
keyword 是 String 搜索词
page_size 否 int 第几页
请求参数示例
{
"aweme_author_sec_uid": "可选",
"aweme_id": "11111",
"page_index": 0,
"page_size": 0,
"wcid": "string"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":[
{},{}]
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
点赞
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/follow/user_digg
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
keyword 是 String 搜索词
page_size 否 int 第几页
请求参数示例
{
"aweme_author_sec_uid": "可选",
"aweme_id": "11111",
"page_index": 0,
"page_size": 0,
"wcid": "string"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":[
{},{}]
}
***
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
评论
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/user/***ment_publish2
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
aweme_id 是 string 视频aweme_id
content 是 string 评论内容
请求参数示例
{
"content": "非常赞哦",
"aweme_id": "11111",
"wcid": "string"
}
成功返回示例
{
"code": 0,
"data": {
"code": 0,
"data": {
"***ment": {
"aweme_id": "6992851582635347231",
"cid": "7106820952499782436",
"create_time": 1654685707,
"digg_count": 0,
"image_list": null,
"label_list": null,
"reply_***ment": null,
"reply_id": "0",
"reply_to_reply_id": "0",
"status": 7,
"text": "非常喜欢",
"text_extra": [],
"text_music_info": null,
"user": {
"a***ept_private_policy": false,
"a***ount_region": "",
"ad_cover_url": null,
"apple_a***ount": 0,
"authority_status": 2,
"avatar_168x168": {
"height": 720,
"uri": "168x168/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61",
"url_list": [
"https://p9.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_168x168.webp?from=2956013662",
"https://p11.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_168x168.webp?from=2956013662",
"https://p26.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_168x168.webp?from=2956013662",
"https://p9.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_168x168.jpeg?from=2956013662"
],
"width": 720
},
"avatar_300x300": {
"height": 720,
"uri": "300x300/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61",
"url_list": [
"https://p9.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_300x300.webp?from=2956013662",
"https://p11.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_300x300.webp?from=2956013662",
"https://p26.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_300x300.webp?from=2956013662",
"https://p9.douyinpic.***/img/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61~c5_300x300.jpeg?from=2956013662"
],
"width": 720
},
"avatar_larger": {
"height": 720,
"uri": "1080x1080/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61",
"url_list": [
"https://p9.douyinpic.***/aweme/1080x1080/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p11.douyinpic.***/aweme/1080x1080/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p26.douyinpic.***/aweme/1080x1080/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p9.douyinpic.***/aweme/1080x1080/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.jpeg?from=2956013662"
],
"width": 720
},
"avatar_medium": {
"height": 720,
"uri": "720x720/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61",
"url_list": [
"https://p9.douyinpic.***/aweme/720x720/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p11.douyinpic.***/aweme/720x720/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p26.douyinpic.***/aweme/720x720/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p9.douyinpic.***/aweme/720x720/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.jpeg?from=2956013662"
],
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "100x100/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61",
"url_list": [
"https://p9.douyinpic.***/aweme/100x100/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p11.douyinpic.***/aweme/100x100/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p26.douyinpic.***/aweme/100x100/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.webp?from=2956013662",
"https://p9.douyinpic.***/aweme/100x100/aweme-avatar/mosaic-legacy_2fa6300033526861f8d61.jpeg?from=2956013662"
],
"width": 720
},
"avatar_uri": "aweme-avatar/mosaic-legacy_2fa6300033526861f8d61",
"aweme_control": {
"can_***ment": true,
"can_forward": true,
"can_share": true,
"can_show_***ment": true
},
"aweme_count": 0,
"aweme_hotsoon_auth": 1,
"aweme_hotsoon_auth_relation": 1,
"ban_user_functions": null,
"bind_phone": "",
"can_set_geofencing": null,
"card_entries": null,
"card_entries_not_display": null,
"card_sort_priority": null,
"cf_list": null,
"cha_list": null,
"close_friend_type": 0,
"***ment_filter_status": 0,
"***ment_setting": 0,
"***merce_user_level": 0,
"constellation": 11,
"cover_url": [
{
"height": 720,
"uri": "c8510002be9a3a61aad2",
"url_list": [
"https://p9.douyinpic.***/obj/c8510002be9a3a61aad2?from=2956013662",
"https://p11.douyinpic.***/obj/c8510002be9a3a61aad2?from=2956013662",
"https://p26.douyinpic.***/obj/c8510002be9a3a61aad2?from=2956013662"
],
"width": 720
}
],
"create_time": 1583420793,
"custom_verify": "",
"cv_level": "",
"display_info": null,
"download_prompt_ts": 0,
"download_setting": -1,
"duet_setting": 0,
"enable_nearby_visible": true,
"enterprise_verify_reason": "",
"favoriting_count": 0,
"fb_expire_time": 0,
"follow_status": 0,
"follower_count": 0,
"follower_request_status": 0,
"follower_status": 0,
"followers_detail": null,
"following_count": 0,
"geofencing": [],
"google_a***ount": "",
"has_email": false,
"has_facebook_token": false,
"has_insights": false,
"has_orders": false,
"has_twitter_token": false,
"has_unread_story": false,
"has_youtube_token": false,
"hide_location": false,
"hide_search": false,
"homepage_bottom_toast": null,
"ins_id": "",
"interest_tags": null,
"is_ad_fake": false,
"is_binded_weibo": false,
"is_block": false,
"is_blocked_v2": false,
"is_blocking_v2": false,
"is_cf": 0,
"is_discipline_member": false,
"is_gov_media_vip": false,
"is_mix_user": false,
"is_not_show": false,
"is_phone_binded": false,
"is_star": false,
"is_verified": true,
"item_list": null,
"ky_only_predict": 0,
"language": "zh-Hans",
"link_item_list": null,
"live_agreement": 0,
"live_agreement_time": 0,
"live_***merce": false,
"live_status": 0,
"live_verify": 2,
"location": "",
"max_follower_count": 0,
"need_points": null,
"need_re***mend": 1,
"neiguang_shield": 0,
"new_story_cover": null,
"nickname": "羊爱吃狼",
"offline_info_list": null,
"personal_tag_list": null,
"platform_sync_info": null,
"prevent_download": false,
"react_setting": 0,
"reflow_page_gid": 0,
"reflow_page_uid": 0,
"region": "***",
"relative_users": null,
"room_id": 0,
"school_category": 1,
"school_id": "6601125174496462855",
"school_name": "",
"school_poi_id": "",
"school_type": 0,
"search_impr": {
"entity_id": "259097319967019"
},
"sec_uid": "MS4wLjABAAAAQifKtWbFoVMlOP5m1jIi0o4eUipQvtHS0g6vwwut_80",
"secret": 0,
"shield_***ment_notice": 0,
"shield_digg_notice": 0,
"shield_follow_notice": 0,
"short_id": "3574866331",
"show_gender_strategy": 0,
"show_image_bubble": false,
"show_nearby_active": false,
"signature": "记录生活点滴，寻找快乐童年",
"signature_display_lines": 0,
"signature_extra": null,
"special_lock": 1,
"status": 1,
"stitch_setting": 0,
"story_count": 0,
"story_open": false,
"sync_to_toutiao": 0,
"total_favorited": 0,
"tw_expire_time": 0,
"twitter_id": "",
"twitter_name": "",
"type_label": null,
"uid": "259097319967019",
"unique_id": "yangaichilan",
"unique_id_modify_time": 1654685707,
"urge_detail": {
"user_urged": 0
},
"user_canceled": false,
"user_mode": 0,
"user_not_see": 0,
"user_not_show": 1,
"user_period": 0,
"user_permissions": null,
"user_rate": 1,
"user_tags": null,
"verification_type": 1,
"verify_info": "",
"video_icon": {
"height": 720,
"uri": "",
"url_list": [],
"width": 720
},
"weibo_name": "",
"weibo_schema": "",
"weibo_url": "",
"weibo_verify": "",
"white_cover_url": null,
"with_***merce_entry": false,
"with_dou_entry": false,
"with_fusion_shop_entry": false,
"with_shop_entry": false,
"youtube_channel_id": "",
"youtube_channel_title": "",
"youtube_expire_time": 0
},
"user_digged": 0
},
"extra": {
"fatal_item_ids": [],
"logid": "202206081855070102120400200105308D",
"now": 1654685707000
},
"is_part_see_item": false,
"log_pb": {
"impr_id": "202206081855070102120400200105308D"
},
"status_code": 0,
"status_msg": "评论成功"
},
"msg": "ok"
},
"msg": "su***ess"
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
关注
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/user/follow_user_digg
- Content-Type：application/json
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
type 是 int 1: 关注 0: 取消关注
uid 是 stirng 抖音用户 sec_uid注意哦
请求参数示例
{
"uid": "MS4wLjABAAAAQ5Gns7yo8y9Q9hQWADdnP48T97w5mb-tq9KFCXDCUjI",
"type": 1,
"wcid": "string"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":{}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
进入直播间
创建时间：2022-11-02 18:02:52 更新时间：2022-11-02 18:02:52
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/live/enter_room
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
mix_id 是 String id
page_size 否 int 第几页
请求参数示例
{
"room_ids": "string", // 多个逗号隔开
"wcid": "string"
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":{"r1":true,"r2":false
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
获取抖音热榜
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/live/get_hot_ranklist_rooms
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
请求参数示例
{
"wcid": "153551136689750xxx"
}
成功返回示例
{
"code": 0,
"data": {
"data": {
"ranks": [
{
"gap_description": "",
"label": "",
"rank": 1,
"raw_ad_data": "",
"room": {
"challenge_info": "",
"content_label": {
"avg_color": "#DCDCFA",
"flex_setting_list": [],
"height": 0,
"image_type": 0,
"is_animated": false,
"open_web_url": "",
"text_setting_list": [],
"uri": "webcast/webcast_hot_rank_redPackage_light_20201118.png",
"url_list": [
"http://p6-webcast.douyinpic.***/img/webcast/webcast_hot_rank_redPackage_light_20201118.png~tplv-resize:0:0.image",
"http://p3-webcast.douyinpic.***/img/webcast/webcast_hot_rank_redPackage_light_20201118.png~tplv-resize:0:0.image",
"http://p9-webcast.douyinpic.***/img/webcast/webcast_hot_rank_redPackage_light_20201118.png~tplv-resize:0:0.image"
],
"width": 0
},
"cover": {
"avg_color": "#***A3BE",
"flex_setting_list": [],
"height": 0,
"image_type": 0,
"is_animated": false,
}
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
获取热播榜（小时）
创建时间：2022-11-02 18:02:52 更新时间：2022-11-02 18:02:52
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/live/get_hothour_ranklist_rooms
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
anchor_id 是 String id
sec_anchor_id 是 int
room_id 是 String id
请求参数示例
{
"anchor_id": "4416096245649518",
"room_id": "7107858435835808546",
"sec_anchor_id": "MS4wLjABAAAAd7M5_hVqarquigSl3t-Kuw-e8_ehsovZvmKmfXvyg8KyjWTPZZFQo-K5BtkA8_zZ",
"wcid": "xxx"
}
成功返回示例
{
"code": 0,
"data": {
"data": {
"anchor_info": {
"city_code": "",
"delta": 0,
"fixed_footer_description": "",
"foot_desc": "已参与排名",
"gap_description": "",
"gap_rich_description": "",
"is_hide_support_button": true,
"rank": 1,
"rank_name": "rank_anchor_hour",
"rich_description": "",
"score": 0,
"score_desc": "",
"shop_tags": [],
"status": 0,
"user": {
"adversary_authorization_info": 0,
"adversary_user_status": 0,
"age_range": 0,
"allow_be_located": false,
"allow_find_by_contacts": false,
"allow_others_download_video": false,
"allow_others_download_when_sharing_video": false,
"allow_share_show_profile": false,
"allow_show_in_gossip": false,
"allow_show_my_action": false,
"allow_strange_***ment": false,
"allow_unfollower_***ment": false,
"allow_use_linkmic": false,
}
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
获取直播间人气榜
创建时间：2022-11-02 18:02:52 更新时间：2022-11-02 18:02:52
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/live/popularity
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
anchor_id
room_id
请求参数示例
{
"wcid": "153551136689750xxx",
"anchor_id":"",
"room_id":""
}
成功返回示例
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
获取直播间带货榜
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/live/shop_ranklist
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
anchor_id
room_id
hour_info
请求参数示例
{
"wcid": "153551136689750xxx",
"anchor_id":"",
"room_id":"",
}
成功返回示例
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
获取对方粉丝群列表
注意：
- 合作后可测试
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/group/other_list
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
sec_owner_uid 是 String
请求参数示例
{
"sec_owner_uid": "string",
"wcid": ""
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":{
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
加入粉丝团
注意：
- 合作后可测试
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/group/join
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
group_id 是 String
请求参数示例
{
"group_id": "string",
"wcid": ""
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":{
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
加入粉丝团
创建时间：2022-11-02 18:02:52 更新时间：2022-11-02 18:02:52
注意：
- 合作后可测试
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/group/join
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
group_id 是 String
请求参数示例
{
"group_id": "string",
"wcid": ""
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":{
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
获取粉丝团成员的详情
基本信息
- 接口状态：开发中
- 接口URL：POST{APIURL}/dy/group/member_detail
- Content-Type：multipart/form-data
- 认证方式：无需认证
参数
参数名 必选 类型 说明
wcid 是 string 会话ID
group_id 是 String
uid 是 String
请求参数示例
{
"group_id": "string",
"uid":"",
"wcid": ""
}
成功返回示例
{
"msg": "su***ess",
"code": 0,
"data":{
}
}
错误返回示例
{
"msg": "失败",
"code": -1,
"data": null
}
返回数据：
参数名 类型 说明
code string 0成功，-1失败
msg string 反馈信息
data
