发起代入驻请求
服务商代商家发起抖音开放平台入驻请求,入驻信息包括当前在抖音开放平台入驻的基础信息。如果入参的注册手机号未在抖音开放平台注册,则会自动注册,商家可以使用该注册手机号登录抖音开放平台。
使用限制
- 每天限制自动注册帐号上限,按照注册的手机号判断,每个第三方小程序应用 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 |
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 |
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个 |