发起代入驻请求

更新时间 2024-07-24 02:58:49
收藏
我的收藏

服务商代商家发起抖音开放平台入驻请求,入驻信息包括当前在抖音开放平台入驻的基础信息。如果入参的注册手机号未在抖音开放平台注册,则会自动注册,商家可以使用该注册手机号登录抖音开放平台。

使用限制

  • 每天限制自动注册帐号上限,按照注册的手机号判断,每个第三方小程序应用 appid一天最多可代10个手机号注册,超过则驳回。
  • 发起入驻请求的手机号如果是入驻中或已入驻,则驳回。

接口说明

  • 平台基于信息进行审核,审核结果会在10个工作日内通过回调告知。
  • 该接口仅适用于第三方小程序应用。

基本信息

基本信息

HTTP URL

https://open.microapp.bytedance.com/openapi/v1/settle/apply

HTTP Method

POST

请求头

名称

类型

必填

描述

content-type

string

固定值 "application/json"

请求参数

Query

名称

类型

是否必填

描述

示例值

component_appid

string

第三方小程序应用 appid

ttd429**********91

component_access_token

string

第三方小程序应用接口调用凭据

628f1******e93b9

Body

名称

类型

是否必填

描述

示例值

mobile

string

手机号,若未注册抖音开放平台,则自动注册

188********

qualification_type

int32

主体类型

  • 1: 企业
  • 2:个体工商户
  • 3:党政机关
  • 4:事业单位
  • 5:港澳台
  • 6:社会组织
  • 7:境外
  • 100:其他组织

1

company_name

string

企业名称

****有限责任公司

credit_code

string

营业执照编号

924******D4U

credit_image_path

string

营业执照照片路径

需要使用第三方小程序应用上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 1,否则报错。

tos-i-giy***8/ddc*****1c6

credit_end_date

string

营业执照有效期,格式:2006-01-02,永久用 0 表示

2023-12-31

company_type

int32

企业类型

  • 1:有限责任公司
  • 2:有限责任公司(自然人独资)
  • 3:有限责任公司(自然人投资或控股)
  • 4:有限责任公司(法人独资)
  • 5:股份有限责任公司
  • 100:其他

1

legal_person_name

string

法人姓名

张**

registered_nation_code

int32

注册地址,国家编号,参考国家及城市编号说明;主体类型为境外时必填,否则不填

840

registered_province_code

int32

注册地址,省份编号,参考国家及城市编号说明;主体类型不为境外时必填,否则不填

110000

registered_city_code

int32

注册地址,城市编号,参考国家及城市编号说明;主体类型不为境外时必填,否则不填

110100

registered_address

string

注册地址,详细地址

海淀区*****

registered_capital

int64

注册资本,单位元

100000

category_code

string

经营行业类目编号,多个使用","隔开,参考经营行业类目编号说明

156,157

business_person_name

string

运营人员姓名

李**

business_id_card

string

运营人员身份证号

44*******21

business_mobile

string

运营人员手机号

188********

company_introduction

string

公司简介,最多140个文字

公司介绍

business_province_code

int32

经营地址/住所,省份编号,参考城市编号说明

110000

business_city_code

int32

经营地址/住所,城市编号,参考城市编号说明

110100

business_address

string

经营地址/住所,详细地址

海淀区*****

employee_count

int64

公司员工总数

1000

company_website

string

官网地址

https://****.com

请求示例

{
  "mobile": "188********",
  "qualification_type": 1,
  "company_name": "****有限责任公司",
  "credit_code": "924******D4U",
  "credit_image_path": "tos-i-giy***8/ddc*****1c6",
  "credit_end_date": "2023-12-31",
  "company_type": 1,
  "legal_person_name": "张**",
  "registered_province_code": 110000,
  "registered_city_code": 110100,
  "registered_address": "海淀区*****",
  "registered_capital": 100000,
  "category_code": "156,157",
  "business_person_name": "李**",
  "business_id_card": "44*******21",
  "business_mobile": "188********",
  "company_introduction": "公司介绍",
  "business_province_code": 110000,
  "business_city_code": 110100,
  "business_address": "海淀区*****",
  "employee_count": 1000,
  "company_website": "https://****.com"
}

响应参数

名称

类型

是否必填

描述

示例值

errno

int

错误码

0

message

string

错误信息

success

log_id

string

标识请求的唯一id

202008121419360101980821035705926A

data

object

响应数据,成功才有值


data 说明:

名称

类型

是否必填

描述

示例值

apply_id

string

申请请求id,用来查询入驻状态

71843****90767916

响应示例

正常示例

{
  "errno": 0,
  "message": "success",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "apply_id": "123456789"
  }
}

异常示例

{
  "errno": 40001,
  "message": "参数错误",
  "log_id": "202008121419360101980821035705926A"
}

错误码

HTTP 状态码

错误码

描述

排查建议

200

40001

参数错误

查看传参是否正确

200

40003

找不到相关第三方小程序应用

确定 component_appid 是否正确

200

40009

第三方小程序应用 component_access_token 已过期

确定 component_access_token 是否过期

200

40010

第三方小程序应用 component_access_token 不正确

确定 component_access_token 是否正确

200

40052

入驻信息不正确,会返回具体的错误字段

查看传参是否合法

200

40053

该账号正在入驻该公司主体,不能重复入驻


200

40054

该账号正在入驻其他公司主体,不能重复入驻


200

40055

该账号已入驻该公司主体,无需重复入驻


200

40056

该账号已入驻其他公司主体,不能重复入驻


200

40057

超过每天自动注册帐号上限10个