代入驻预审

我的收藏

该接口的功能能够在代商家入驻抖音开放平台前提前检查入驻所需的信息是否准确。

接口说明

该接口可选择性调用，接口可实时返回检验结果。
该接口仅适用于第三方小程序应用。

基本信息

基本信息
HTTP URL	https://open.microapp.bytedance.com/openapi/v1/settle/pre_check
HTTP Method	POST

请求头

名称	类型	必填	描述
content-type	string	是	固定值 "application/json"

请求参数

Query

名称	类型	是否必填	描述	示例值
component_appid	string	是	第三方小程序应用 appid	ttd429**********91
component_access_token	string	是	第三方小程序应用接口调用凭据	628f1******e93b9

Body

名称	类型	是否必填	描述	示例值
qualification_type	int32	是	主体类型 1：企业 2：个体工商户 3：党政机关 4：事业单位 5：港澳台 6：社会组织 7：境外 100：其他组织	1
company_name	string	是	企业名称	****有限责任公司
credit_code	string	是	营业执照编号	924******D4U
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

请求示例

{
  "qualification_type": 1,
  "company_name": "****有限责任公司",
  "credit_code": "924******D4U",
  "credit_end_date": "0",
  "company_type": 1,
  "legal_person_name": "张**",
  "registered_province_code": 110000,
  "registered_city_code": 110100,
  "registered_address": "海淀区*****",
  "registered_capital": 100000
}

响应参数

名称	类型	是否必填	描述	示例值
errno	int32	是	错误码	0
message	string	是	错误信息	success
log_id	string	是	标识请求的唯一id	202008121419360101980821035705926A

响应示例

正常示例

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

异常示例

{
  "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	入驻信息不正确，会返回具体的错误字段	查看传参是否合法

上一篇：查询小程序备案历史详情

下一篇：发起代入驻请求