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

Partial Edit Responsible Person

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/responsible_persons/{responsible_person_id}/partial_edit

#

§2 Method: [POST]

#

§3 Function Description

Edit the details of an EU responsible person 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
responsible_person_idstringY66d3cbe4d9c8b09ddca023f1The responsible person 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 responsible person name.
Max length: 200 characters
emailstringNjohn.doe@email.comThe email address of the responsible person.
phone_numberobjectNThe phone number of the responsible person.
^country_codestringY+353The 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_numberstringY80915151The local number.
Length: 7 - 11 digits
addressobjectNThe residential address of the responsible person.
^street_address_line1stringY63 Cardiff Ln, Grand Canal Dock, Dublin City, DublinThe 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_line2stringN-(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
^districtstringN-(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
^citystringN-(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_codestringYD02 HD23The postal code.
Max length: 500 characters
^provincestringN-(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
^countrystringYIEThe two letter ISO 3166 country code representing the country of the address. It must be an EU country.
localestringNen-IEThe 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/responsible_persons/66d3cbe4d9c8b09ddca023f1/partial_edit?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=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"}
#

§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
38023022Invalid responsible person's name
38023024Invalid responsible person's address
38023025Internal error
38023026Invalid EU country
38023028Invalid EU phone country code
38023041Invalid phone number length
38023042Invalid email format
38023043Invalid address length
38023044Invalid name length
38023050Operation is not supported for global seller
38023051Resource not found
38023052Seller is not authorised to access resource
#