第三方平台
接口说明

提交商铺资质材料

接口介绍

该接口用于第三方应用为授权小程序提交商铺资质材料。

注意:

  • 需要为每个店铺(supplier_ext_id) + 授权小程序组合都上传一遍所有材料,包括:商铺营业执照路径(biz_licence_path)、服务商和商家的合作协议路径(contract_path)、商铺行业资质材料(qual_material)。

请求

基本信息

基本
HTTP URLhttps://open.microapp.bytedance.com/openapi/v1/microapp/operation/add_shop_material
HTTP MethodPOST
权限要求授权小程序授予运营管理权限

查询参数

参数名参数类型是否必须备注
component_appidstring第三方应用 appid
authorizer_access_tokenstring授权小程序接口调用凭据

请求体(json)

参数名参数类型是否必须备注
client_keystring服务商在抖音开放平台的应用唯一标识
supplier_ext_idstring接入方店铺 ID
biz_licence_pathstring商铺营业执照路径
需要使用代授权小程序上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 7,否则报错。
contract_pathstring服务商和商家的合作协议路径
需要使用代授权小程序上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 8,否则报错。
qual_materialArray<object>商铺行业资质材料信息
expire_timestring过期时间
所有材料(营业执照、合作协议、行业资质材料)中的最早到期时间
格式:2021-07-22

qual_material 说明

参数名参数类型是否必须备注
pathstring商铺行业资质材料路径
需要使用代授权小程序上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 7,否则报错。

请求体示例

{
    "client_key": "awxxxxxxxxxxxxxx",
    "supplier_ext_id": "y0001",
    "biz_licence_path": "xxxx/xxxx",
    "contract_path": "xxxx/xxxx",
    "qual_material": [
        {
            "path": "xxxx/xxxx"
        },
        ...
    ],
    "expire_time": "2021-07-22"
}

注意:

  • 按照目前标准,商铺行业资质材料(qual_material)最多只需要上传三份文件,所以多传会导致接口报“参数错误”。

响应

响应体

参数名参数类型备注
errnoint错误码
messagestring错误信息

响应体示例

{
  "errno": 0,
  "message": "success"
}

错误码

错误码message
40001参数错误
40003找不到相关第三方应用
40004找不到相关授权小程序
40020第三方应用 authorizer_access_token 不正确或者已过期
40033获取不到上传的材料,请确认文件路径正确
40036授权小程序未授予该接口对应的权限
40042时间格式有误
点击纠错
评价此篇文档