提交账号验证申请
此接口可用于为商务中心账号或广告账号提交验证申请。
提交验证申请后,你可以使用 /account/verification/status/ 接口监测审核进度。
准备工作
确保已通过 /account/verification/upload/ 接口上传验证文件,并准备好 qualification_image_ids。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/account/verification/submit/
方法 POST
Header
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值:`application/json`。|
参数
|字段{34%}|类型{11%}|描述{55%}|
|---|---|---|
|advertiser_id {+条件必填}|string|必须设置 `advertiser_id` 或 `bc_id`。<br><br>需提交验证申请的广告账号的 ID。<ul><li>如果提交自己的验证文件,需拥有广告账号的管理员或操作员权限。若想验证该权限,你可以将 `ADVERTISER` 作为 `asset_type` 传入 [/bc/asset/get/](https://business-api.tiktok.com/portal/docs/get-assets/v1.3) 接口,并查看返回的 `advertiser_role` 是否为 `ADMIN` 或 `OPERATOR`。</li><li>如果重复使用他人的验证文件,需拥有相应的权限:<ul><li>若想重复使用其他广告账号的验证文件,需拥有该账号的管理员或操作员权限。通过 [/bc/asset/get/](https://business-api.tiktok.com/portal/docs/get-assets/v1.3) 接口验证权限(将 `ADVERTISER` 作为 `asset_type` 传入,并查看返回的 `advertiser_role` 是否为 `ADMIN` 或 `OPERATOR`)。</li><li>若想重复使用其他商务中心账号的验证文件,需拥有该账号的管理员权限。通过 [/bc/get/](https://business-api.tiktok.com/portal/docs/get-business-centers/v1.3) 接口验证权限,并查看返回的 `user_role` 是否为 `ADMIN`。</li></ul></li></ul>|
|bc_id {+条件必填}|string|必须设置 `advertiser_id` 或 `bc_id`。<br><br>需提交验证申请的商务中心账号的 ID。<br><br>你需要拥有该商务中心账号的管理员权限。<br><br>若想使用其他商务中心账号的验证文件,需拥有该账号的管理员权限。通过 [/bc/get/](https://business-api.tiktok.com/portal/docs/get-business-centers/v1.3) 接口验证权限,并查看返回的 `user_role` 是否为 `ADMIN`。|
|business_form {+条件必填}|object|必须设置 `business_form` 或 `individual_form`。<br><br>你的企业验证详细信息。<br><br>若想提交企业验证申请,需指定此字段。|
#|company_name {+条件必填}|string|当传入 `business_form` 时,此为必填字段。<br><br>公司名称。<br><br>你在此处指定的公司名称必须与验证文件上的名称完全一致。验证完成后,你将无法更改公司名称。<br><br>长度限制:128 个字符。|
#|website_url {+条件必填}|string|当传入 `business_form` 时,此为必填字段。<br><br>公司网站 URL。<br><br>长度限制:512 个字符。|
#|industry_code {+条件必填}|string|当传入 `business_form` 时,此为必填字段。<br><br>你的企业所属的行业类别。<br><br>枚举值:<ul><li>`NOT_APPLICABLE`:不适用。</li><li>`ALCOHOL`:酒类。</li><li>`OTC`:非处方药。</li><li>`DATING_APP`:交友应用。</li><li>`FINANCIAL_SERVICES`:金融服务。</li></ul>|
#|region_iso_code {+条件必填}|string|当传入 `business_form` 时,此为必填字段。<br><br>你的企业(商务中心账号或广告账号)所在国家或地区的代码,采用 ISO 3166 格式。<br><br>示例:`US`。<br><br><ul><li>若想获取商务中心账号的国家或地区代码,需使用 [/bc/get/](https://business-api.tiktok.com/portal/docs/get-business-centers/v1.3) 接口并查看返回的 `registered_area` 参数。</li><li>若想获取广告账号的国家或地区代码,需使用 [/advertiser/info/](https://business-api.tiktok.com/portal/docs/get-ad-account-details/v1.3) 接口并查看返回的 `country` 参数。</li></ul>|
#|file_type_code {+条件必填}|string|当传入 `business_form` 时,此为必填字段。<br><br>验证文件的代码。<br><br>若想获取你的企业可用的验证文件代码,需使用 [/account/verification/filetype/](https://business-api.tiktok.com/portal/docs/get-available-verification-document-types-for-a-region/v1.3) 接口。|
#|license_no {+条件必填}|string|当传入 `business_form` 时,此为必填字段。<br><br>验证文件的证书编号。<br><br>确保你在此处指定的编号与文件上的编号一致。证书编号在提交后无法更改。<br><br>长度限制:128 个字符。|
#|qualification_image_ids {+条件必填}|string[]|当传入 `business_form` 时,此为必填字段。<br><br>企业验证文件的资质图片 ID 列表。<br><br>需指定一个 ID。<br><br>若想获取企业验证文件的资质图片 ID,需使用 [/account/verification/upload/](https://business-api.tiktok.com/portal/docs/upload-verification-documents/v1.3) 接口。|
|individual_form {+条件必填}|object|必须设置 `business_form` 或 `individual_form`。<br><br>你的个人身份验证详细信息。<br><br>若想提交个人身份验证申请,需指定此字段。|
#|individual_name {+条件必填}|string|当传入 `individual_form` 时,此为必填字段。<br><br>法定全名。<br><br>你在此处指定的名称必须与验证文件上的名称完全一致。验证完成后,你将无法更改此名称。<br><br>长度限制:128 个字符。|
#|region_iso_code {+条件必填}|string|当传入 `individual_form` 时,此为必填字段。<br><br>你的企业(商务中心账号或广告账号)所在国家或地区的代码,采用 ISO 3166 格式。<br><br>示例:`US`。<br><br><ul><li>若想获取商务中心账号的国家或地区代码,需使用 [/bc/get/](https://business-api.tiktok.com/portal/docs/get-business-centers/v1.3) 接口并查看返回的 `registered_area` 参数。</li><li>若想获取广告账号的国家或地区代码,需使用 [/advertiser/info/](https://business-api.tiktok.com/portal/docs/get-ad-account-details/v1.3) 接口并查看返回的 `country` 参数。</li></ul>|
#|file_type_code {+条件必填}|string|当传入 `individual_form` 时,此为必填字段。<br><br>验证文件的代码。<br><br>若想获取你的企业可用的验证文件代码,需使用 [/account/verification/filetype/](https://business-api.tiktok.com/portal/docs/get-available-verification-document-types-for-a-region/v1.3) 接口。|
#|identity_no {+条件必填}|string|当传入 `individual_form` 时,此为必填字段。<br><br>身份证件号码。<br><br>确保你在此处指定的号码与政府签发的身份证件(驾照、护照等)上的号码一致。此号码提交后无法更改。<br><br>长度限制:128 个字符。|
#|website_url {+条件必填}|string|当传入 `individual_form` 时,此为必填字段。<br><br>公司网站 URL。<br><br>长度限制:512 个字符。|
#|qualification_image_ids {+条件必填}|string[]|当传入 `individual_form` 时,此为必填字段。<br><br>个人身份证明文件的资质图片 ID 列表。<br><br>需指定两个 ID,分别对应正面和反面图片。<br><br>若想获取个人身份证明文件的资质图片 ID,需使用 [/account/verification/upload/](https://business-api.tiktok.com/portal/docs/upload-verification-documents/v1.3) 接口。|
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/account/verification/submit/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"business_form": {
"company_name": "{{company_name}}",
"website_url": "{{website_url}}",
"industry_code": "OTC",
"region_iso_code": "US",
"file_type_code": "{{file_type_code}}",
"license_no": "{{license_no}}",
"qualification_image_ids": [
"{{qualification_image_ids}}"
]
}
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID,唯一标识一个请求。|
|data|object|返回数据。|
示例
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {}
}
(/code)