上传验证文件
此接口可用于上传验证文件。
成功上传文件后,调用 /account/verification/submit/ 接口,正式提交账号验证申请。
准备工作
- 调用 /account/verification/filetype/ 接口确认你的账号支持的企业验证文件或个人身份证明文件类型。
- 查看验证失败的常见原因和建议列表,熟悉常见的误区。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/account/verification/upload/
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br><br>允许值:`multipart/form-data`。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|image_file1 {必填}|file|验证文件。<br>你可以指定企业验证文件或个人身份证明文件。<br><br>对于通常需要两张图片(正面和反面)的个人身份验证申请,你可以通过 `image_file1` 提供正面图片,通过 `image_file2` 提供反面图片。<br><br>文件大小:不超过 10 MB。<br><br>支持的格式:JPEG、PNG、JPG。|
|image_file2|file|其他验证文件。<br>你可以指定企业验证文件或个人身份证明文件。<br><br>对于通常需要两张图片(正面和反面)的个人身份验证申请,你可以通过 `image_file1` 提供正面图片,通过 `image_file2` 提供反面图片。<br><br>文件大小:不超过 10 MB。<br><br>支持的格式:JPEG、PNG、JPG。|
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/account/verification/upload/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: multipart/form-data' \
--form 'image_file1=@"{{image_file1}}"'
(/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|返回数据。|
#|qualification_image_ids|string[]|资质图片 ID 列表。<br><br>ID 数量可能为 1 个或 2 个,具体数量取决于已上传文件的总数。|
示例
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"qualification_image_ids": [
"{{qualification_image_id}}"
]
}
}
(/code)