快工助手跨境电商知识与商机助手

Partial Edit Manufacturer

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 Path: /product/202409/compliance/manufacturers/{manufacturer_id}/partial_edit

#

§2 Method: [POST]

#

§3 Function Description

Edit the details of a manufacturer in the EU languages supported by TikTok Shop. Include the locale code to edit the responsible person's information in a particular language. Target seller: Local sellers operating in EU countries Note:

  • Updates are handled per top-level property, so all non-empty fields within an updated object must be supplied to prevent overwriting with blanks.
  • For top-level properties (e.g. name, email) that are not nested in an object, you can update them individually. Omitting these properties in the request will leave them unchanged.
  • If you need to edit any nested property within an object, you must provide values for all nested properties of that object. Any omitted nested properties will be overwritten with blanks. For example, if you want to update phone_number.local_number, you must also include the country_code property to avoid data loss for that property.

#

§4 Common Parameters

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Properties Location Type Require Sample Properties description
content-typeheaderstringYapplication/jsonAllowed type: application/json
#

§5 Request Path Parameters

Properties Type Require Sample Properties description
manufacturer_idstringY66d3cbe4d9c8b09ddca932a7The manufacturer ID in TikTok Shop.
#

§6 Request Query Parameters

Properties Type Require Sample Properties description
app_keystringY38abcdEvery single app will have a unique key. Please use the specific key assigned to your app.
signstringY5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8cSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestampintY1623812664Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
#

§7 Request Body Parameters

Properties Type Require Sample Properties description
namestringNJohn DoeThe manufacturer name.
Max length: 255 characters
registered_trade_namestringNTikTok ShopThe registered trade name of the manufacturer.
Max length: 200 characters
emailstringNjohndoe@email.comThe email address of the manufacturer.
phone_numberobjectNThe phone number of the manufacturer.
^availabilitystringNAVAILABLEIndicates 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 |N |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 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. |

#

§8 Request Sample

Query

https://open-api.tiktokglobalshop.com/product/202409/compliance/manufacturers/66d3cbe4d9c8b09ddca932a7/partial_edit?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=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"}
#

§9 Response Parameters

Properties Type Sample Properties description
codeint0The success or failure status code returned in API response.
messagestringSuccessThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstring202203070749000101890810281E8C70B7Request log
dataobjectSpecific return information
#

§10 Response Sample

{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
#

§11 Error Code

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code

Code Message
38023025Internal error
38023033Invalid manufacturer's name
38023034Invalid manufacturer's address
38023037Invalid manufacturer's registered trade name
38023041Invalid phone number length
38023042Invalid email format
38023043Invalid address length
38023044Invalid name length
38023045Invalid registered trade name length
38023046Invalid phone country code format
38023050Operation is not supported for global seller
38023051Resource not found
38023052Seller is not authorised to access resource
38023060Invalid phone number availability. Supported values: AVAILABLE, UNAVAILABLE
#