第三方平台
接口说明

查询商铺资质材料状态

接口介绍

该接口用于查询第三方应用为授权小程序提交商铺资质材料的状态信息。

请求

基本信息

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

查询参数

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

响应体

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

data 说明

参数名参数类型备注
online_shop_materialobject线上版资质信息
audit_shop_materialobject审核版资质信息

online_shop_material 说明

参数名参数类型备注
statusint状态,1:上线,2:下线
biz_licenceobject商铺营业执照信息
contractobject服务商和商家的合作协议信息
qual_materialArray<object>商铺行业资质材料信息

biz_licence、contract、qual_material 说明

参数名参数类型备注
pathstring资质材料链接

audit_shop_material 说明

参数名参数类型备注
biz_licenceobject商铺营业执照信息
contractobject服务商和商家的合作协议信息
qual_materialArray<object>商铺行业资质材料信息

biz_licence、contract、qual_material 说明

参数名参数类型备注
pathstring资质材料链接
statusobject状态,1:审核中,2:审核成功,3:审核失败
reasonArray<string>审核失败原因

注意:

  • 商铺营业执照、服务商和商家的合作协议、商铺行业资质材料都是分开审核,当且只有三者都通过审核才会变更为线上版资质。

响应体示例

{
  "errno": 0,
  "message": "success",
  "data": {
    "online_shop_material": {
      "status": 1,
      "biz_licence": {
        "path": "https://lf3-developer-sign.bytemastatic.com/developer/thirdparty/xxx/xxx/shop_contract/c36ff08137"
      },
      "contract": {
        "path": "xxxxx"
      },
      "qual_material": [
        {
          "path": "xxxxx"
        }
      ]
    },
    "audit_shop_material": {
      "biz_licence": {
        "path": "xxxx",
        "status": 1
      },
      "contract": {
        "path": "xxxxxxxx",
        "status": 2
      },
      "qual_material": [
        {
          "path": "xxxxx",
          "status": 3,
          "reason": [
            "您好,您所认领的门店名称与门店主体无关,请核对认领门店名称是否正确或提供其他补充材料,谢谢。"
          ]
        }
      ]
    }
  }
}

错误码

错误码message
40001参数错误
40003找不到相关第三方应用
40004找不到相关授权小程序
40020第三方应用 authorizer_access_token 不正确或者已过期
40036授权小程序未授予该接口对应的权限
点击纠错
评价此篇文档