开发
API

拍抖音黑白名单管理能力

提供拍抖音的黑白名单管理能力,开发者可以决定哪些用户拍抖音时可以挂载他们的小程序(白名单),哪些用户拍抖音时不可以挂载他们的小程序(黑名单)。

小程序设置了白名单后,只有白名单内的用户才能够挂载小程序,其他用户均不可挂载;小程序设置了黑名单后,黑名单内的用户不可以挂载小程序,其他用户均可以进行挂载;如果小程序黑白名单都没有设置,那么默认所有用户都可以进行挂载小程序;如果小程序同时设置了黑白名单,以白名单为准,只有白名单内的用户才可以挂载小程序。

请求地址

POST   https://developer.toutiao.com/api/apps/share_config

请求验证

请求需要验证授权,详见验证授权

请求参数

属性数据类型必填说明
appidstring小程序的 appID
uniq_idstring用户抖音号
access_tokenstring授权验证
typeint操作类型,详情见下表

操作类型 type 参数详情

Type说明
1黑名单增加用户
2白名单增加用户
3黑名单删除用户
4白名单删除用户

返回值

返回值为 JSON 形式

当服务端正确返回时,会返回如下信息:

属性数据类型说明
datastring成功时,返回”success“
err_noint错误号,成功时返回 0
err_tipsstring错误信息,成功时返回空

errCode

当请求失败时,会返回非 0 的err_no,错误信息会携带在 err_tips 中,错误码含义如下:

错误号描述
-1系统错误
10001传入 appid 为空
10010传入抖音号为空
10011传入 accessToken 为空
11016accessToken 校验不通过
11017无效的 uniqID
11018无效的操作行为类型

请求示例

{
  "appid": "tt5daf2b12c28****",
  "uniq_id": "20107****",
  "access_token": "08011218466f624b33532f75514364726168334243325a7********",
  "type": 1
}

返回示例

成功返回

{
  "data": "success",
  "err_no": 0,
  "err_tips": ""
}

错误返回

{
  "err_no": -1,
  "err_tips": "system error"
}
点击纠错
评价此篇文档