发起代入驻请求

更新时间 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个

下一篇：服务商平台概述

文档评论

登录后可参与评论