角色授权小程序

开发环境

http://dev-cn.your-api-server.com

POST

https://developer.toutiao.com/auth/entity/auth_role

接口说明

该接口用于角色授权小程序，某角色将运营的权限授予给某个小程序。

创建沙盒环境小程序时请选择“正式小程序能力映射”，详情请关注行业角色系统能力文档。

例如：

老师和代运营模式机构将运营权限授予给服务商下的某个小程序

自营机构将权限授予给自己的小程序

前提条件

实体ID 已经存在

服务商或机构实体已绑定小程序

开发者需要在开发者运营平台完成主体认证(入驻开发者平台)

注意事项

若未做额外备注，string 类型的默认字段默认支持字符集 utf-8请求

access_token获取的方式获取access_token

实体审核与类目审核都通过后，角色才算入驻完成，才可以进行授权小程序

基本信息

基本
HTTP URL	正式环境：https://developer.toutiao.com/auth/entity/auth_role 沙盒环境：https://open-sandbox.douyin.com/auth/entity/auth_role
HTTP Method	POST
权限要求	AccessToken鉴权

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/auth/entity/auth_role' \
--header 'Aweme-Check-Type;' \
--header 'Content-Type: application/json' \
--data-raw '{ 
  "appid": "tt427e34c3dd07777601",
  "access_token": "080112184630xxx947774a45363371682f48762f4c67326974513d3d",
  "partner_entity_id": "E_7208933888470106156",
  "merchant_entity_id": "E_7208933889593688108",
  "industry_code": 10000,
  "auth_letters": [
    {
      "material_type": 1006,
      "material_expiretime": "2033-01-01",
      "material_paths": [
        "certification/resource/c1bb104b7a84fb40e58f89a91cf19b22"
      ]
    }
  ],
  "scope": 2,
  "nick": "哈哈哈",
  "icon": "certification/resource/c1bb104b7a84fb40e58f89a91cf19b22",
  "desc": "哈哈",
  "merchant_industry_role": 2
}'

响应示例

{
    "bind_taskid": "string",
    "err": {
        "err_code": 0,
        "err_msg": "string"
    }
}

请求参数

Header 参数

Content-Type

string

必需

Aweme-Check-Type

string

可选

Body 参数application/json

appid

string

小程序appid

必需

access_token

string

必需

小程序的AccessToken

partner_entity_id

string

可选

服务商实体ID ，服务商帮助老师或代运营模式机构添加授权信息时必填（需先确保服务商实体已绑定该小程序）

merchant_entity_id

string

必需

被授权实体（如果是机构授权给自己需确保机构已绑定该小程序）

industry_code

integer

必需

行业编码，泛知识10000

auth_letters

array [object {3}]

可选

机构授权给自己不需要授权函其它情况授权给服务商需要授权函 len(auth_letters)=1

material_type

integer

必需

材料类型，目前支持的类型见上传材料接口

material_expiretime

string

可选

材料过期时间，示例：2029-09-10

material_paths

array[string]

必需

材料链接，字符串数组

scope

integer

可选

实体在小程序的权限，按照位或，1：可支付/收款权限 2：可以创建课程权限

nick

string

必需

老师或机构在小程序内昵称 2<=len<=30 (中文占2个字符)

icon

string

必需

老师或机构在小程序内头像（需要使用上传资质材料接口）

desc

string

必需

老师或机构在小程序描述 1<=len<=2000 (中文占2个字符)

merchant_industry_role

integer

必需

授权实体角色类型（1：老师 2：机构）

示例

返回响应

🟢200成功

application/json

Body

bind_taskid

string

必需

如果是机构授权自己的小程序，不用审核，该字段为空

err

object

必需

err_code

integer

必需

err_msg

string

必需

修改于 2023-12-04 06:36:36

查询小程序已绑定的角色

解除授权小程序

角色授权小程序

接口说明#

注意事项#

基本信息#

请求参数

返回响应

接口说明

注意事项

基本信息