第三方平台
接口说明

提交商铺资质材料

接口介绍

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

注意:

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

请求

基本信息

基本


HTTP URL

https://open.microapp.bytedance.com/openapi/v1/microapp/operation/add_shop_material

HTTP Method

POST

权限要求

授权小程序授予运营管理权限

查询参数

参数名

参数类型

是否必须

备注

component_appid

string

第三方应用 appid

authorizer_access_token

string

授权小程序接口调用凭据

请求体(json)

参数名

参数类型

是否必须

备注

client_key

string

服务商在抖音开放平台的应用唯一标识

supplier_ext_id

string

接入方店铺 ID

biz_licence_path

string

商铺营业执照路径
需要使用代授权小程序上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 7,否则报错。

contract_path

string

商家授权函(或与小程序的合作协议)路径
需要使用代授权小程序上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 8,否则报错。

qual_material

Array<object>

商铺行业资质材料信息

expire_time

string

过期时间
所有材料(营业执照、合作协议、行业资质材料)中的最早到期时间
格式:2021-07-22

qual_material 说明

参数名

参数类型

是否必须

备注

path

string

商铺行业资质材料路径
需要使用代授权小程序上传资源接口返回的路径才可以,接口调用时入参 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)最多只需要上传三份文件,所以多传会导致接口报“参数错误”。
  • 提交商铺资质前,需要保证完成商铺同步并且上线,商铺没有上线会导致接口报“找不到商铺相关信息”。

响应

响应体

参数名

参数类型

备注

errno

int

错误码

message

string

错误信息

响应体示例

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

错误码

错误码

message

40001

参数错误

40003

找不到相关第三方应用

40004

找不到相关授权小程序

40020

第三方应用 authorizer_access_token 不正确或者已过期

40033

获取不到上传的材料,请确认文件路径正确

40036

授权小程序未授予该接口对应的权限

40042

时间格式有误

40047

找不到商铺相关信息

40048

该商铺资质材料正在审核中

40049

该商铺资质材料上传操作太频繁,请稍后重试

点击纠错
评价此篇文档