来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Path: /product/202409/compliance/responsible_persons
#§2 Method: [POST]
#§3 Function Description
Add a new EU responsible person who ensures a seller's products comply with EU regulations. The provided information will be automatically translated into all EU languages supported by TikTok Shop.
- Use the Search Responsible Persons API to obtain the translations.
- Use the Partial Edit Responsible Person API to edit the translations, if necessary.
- When creating a product, pass the returned
responsible_person_idto associate the product with the responsible person.
Target seller: Local sellers operating in EU countries
§4 Common Parameters
For common parameters, refer to How to call TikTok Shop APIs - Common Parameters
| Properties | Location | Type | Require | Sample | Properties description |
|---|---|---|---|---|---|
| content-type | header | string | Y | application/json | Allowed type: application/json |
§5 Request Query Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| app_key | string | Y | 38abcd | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign | string | Y | 5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp | int | Y | 1623812664 | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
§6 Request Body Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| name | string | Y | John Doe | The responsible person name. |
| Max length: 200 characters | ||||
| string | Y | john.doe@email.com | The email address of the responsible person. | |
| phone_number | object | Y | The phone number of the responsible person. | |
| ^country_code | string | Y | +353 | The country code of the phone number, prefixed by a plus + symbol. E.g. +353 for Ireland. Only EU country codes are allowed. |
| Max digits: 4 | ||||
| ^local_number | string | Y | 80915151 | The local number. |
| Length: 7 - 11 digits | ||||
| address | object | Y | The residential address of the responsible person. | |
| ^street_address_line1 | string | Y | 63 Cardiff Ln, Grand Canal Dock, Dublin City, Dublin | The detailed street address of the location, including the building number, street name, district, city, province, and any relevant details. |
| Max length: 500 characters | ||||
| ^street_address_line2 | string | N | - | (Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.) |
| An optional secondary line for additional address details, if necessary. | ||||
| Max length: 500 characters | ||||
| ^district | string | N | - | (Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.) |
The district name.
Max length: 500 characters |
^city |string |N |- |(Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.)
The city name.
Max length: 500 characters |
^postal_code |string |Y |D02 HD23 |The postal code.
Max length: 500 characters |
^province |string |N |- |(Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.)
The province, state, or region name.
Max length: 500 characters |
^country |string |Y |IE |The two letter ISO 3166 country code representing the country of the address. It must be an EU country. |
locale |string |N |en-IE |The BCP-47 locale code representing the language used for specifying the responsible person information.
Possible values:
- de-DE
- en-IE
- es-ES
- fr-FR
- it-IT Default: The locale of the seller's registered business address.
Note: The information provided will be automatically translated into all EU languages supported by TikTok Shop. Ensure the locale matches the language used in field values to avoid inaccurate translations. |
§7 Request Sample
Query
https://open-api.tiktokglobalshop.com/product/202409/compliance/responsible_persons?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1625484268
Body
{"name":"John Doe","email":"john.doe@email.com","phone_number":{"country_code":"+353","local_number":"80915151"},"address":{"street_address_line1":"63 Cardiff Ln, Grand Canal Dock, Dublin City, Dublin","street_address_line2":"-","district":"-","city":"-","postal_code":"D02 HD23","province":"-","country":"IE"},"locale":"en-IE"}
§8 Response Parameters
| Properties | Type | Sample | Properties description |
|---|---|---|---|
| code | int | 0 | The success or failure status code returned in API response. |
| message | string | Success | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | 202203070749000101890810281E8C70B7 | Request log |
| data | object | Specific return information | |
| ^responsible_person_id | string | 66d3cbe4d9c8b09ddca023f1 | A unique ID that identifies the responsible person in TikTok Shop. |
§9 Response Sample
{"code":0,"data":{"responsible_person_id":"66d3cbe4d9c8b09ddca023f1"},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
§10 Error Code
For common error codes, refer to How to call TikTok Shop APIs - Common Error Code
| Code | Message |
|---|---|
| 38023022 | Invalid responsible person's name |
| 38023024 | Invalid responsible person's address |
| 38023025 | Internal error |
| 38023026 | Invalid EU country |
| 38023027 | Number of responsible person exceeds the limit |
| 38023028 | Invalid EU phone country code |
| 38023041 | Invalid phone number length |
| 38023042 | Invalid email format |
| 38023043 | Invalid address length |
| 38023044 | Invalid name length |
| 38023050 | Operation is not supported for global seller |