来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 Path: /product/202409/compliance/manufacturers
#§2 Method: [POST]
#§3 Function Description
Add a manufacturer for a seller. The provided information will be automatically translated into all EU languages supported by TikTok Shop.
- Use the Search Manufacturers API to obtain the translations.
- Use the Partial Edit Manufacturer API to edit the translations, if necessary.
- When creating a product, pass the returned
manufacturer_idto associate the product with the manufacturer. 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 manufacturer name. |
| Max length: 255 characters | ||||
| registered_trade_name | string | N | TikTok Shop | The registered trade name of the manufacturer. |
| Max length: 200 characters | ||||
| string | Y | johndoe@email.com | The email address of the manufacturer. | |
| phone_number | object | Y | The phone number of the manufacturer. | |
| ^availability | string | N | AVAILABLE | Indicates the availability of the phone number. |
| Possible values: |
AVAILABLE: The phone number is available and required.UNAVAILABLE: No phone number is available.
Default: AVAILABLE |
^country_code |string |N |+353 |The country code of the phone number, prefixed by a plus + symbol. E.g. +353 for Ireland.
Max digits: 4
Required if availability=AVAILABLE. |
^local_number |string |N |81234567 |The local number.
Length: 7 - 20 digits
Required if availability=AVAILABLE. |
address |string |Y |10 Earlsfort Terrace, Dublin, Ireland |The postal address of the manufacturer.
Max length: 500 characters |
locale |string |N |en-IE |The BCP-47 locale code representing the language used for specifying the manufacturer 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/manufacturers?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1625484268
Body
{"name":"John Doe","registered_trade_name":"TikTok Shop","email":"johndoe@email.com","phone_number":{"availability":"AVAILABLE","country_code":"+353","local_number":"81234567"},"address":"10 Earlsfort Terrace, Dublin, Ireland","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 | |
| ^manufacturer_id | string | 66d3cbe4d9c8b09ddca932a7 | A unique ID that identifies the manufacturer in TikTok Shop. |
§9 Response Sample
{"code":0,"data":{"manufacturer_id":"66d3cbe4d9c8b09ddca932a7"},"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 |
|---|---|
| 38023025 | Internal error |
| 38023032 | Number of manufacturers exceeds the limit |
| 38023033 | Invalid manufacturer's name |
| 38023034 | Invalid manufacturer's address |
| 38023037 | Invalid manufacturer's registered trade name |
| 38023041 | Invalid phone number length |
| 38023042 | Invalid email format |
| 38023043 | Invalid address length |
| 38023044 | Invalid name length |
| 38023045 | Invalid registered trade name length |
| 38023046 | Invalid phone country code format |
| 38023050 | Operation is not supported for global seller |
| 38023060 | Invalid phone number availability. Supported values: AVAILABLE, UNAVAILABLE |
