Chuyển tới nội dung chính

POST Search Responsible Persons

Tìm kiếm Người chịu trách nhiệm Seller Scope bắt buộc: seller.product.basic Truy xuất danh sách người chịu trách nhiệm theo các ngôn ngữ EU được TikTok Shop hỗ trợ dựa trên ID hoặc từ khóa của họ. Khi tạo sản phẩm, hãy truyền responsible_person_id được trả về để liên kết sản phẩm với người chịu trách nhiệm. Đối tượng seller: Các seller địa phương hoạt động tại các quốc gia EU Phiên bản 202501

POST/product/202501/compliance/responsible_persons/search

Request

Header

PropertiesTypeDescription
content-type RequiredstringLoại được phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của seller từ Get Access Token, khi user_type = 0. Hãy làm theo hướng dẫn này để lấy access_token của seller.

Query

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn.
sign RequiredstringChữ ký được tạo bởi thuật toán gen. Khi gửi yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương.
page_size RequiredintSố lượng kết quả trả về trên mỗi trang. Phạm vi hợp lệ: [1-100]
page_tokenstringMột token mờ được dùng để truy xuất trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ next_page_token trong kết quả của phản hồi trước đó. Không cần cho trang đầu tiên.

Body

PropertiesTypeDescription
responsible_person_ids[]stringLọc kết quả theo các responsible person ID này.Số ID tối đa: Giá trị của page_size
keywordstringLọc kết quả để hiển thị những kết quả chứa từ khóa này.Phạm vi tìm kiếm: name, local_number, emailĐộ dài tối đa: 200 ký tựLưu ý: Cung cấp một trong hai responsible_person_ids hoặc keyword; nếu cả hai được cung cấp, responsible_person_ids sẽ được ưu tiên.
locales[]stringCác mã ngôn ngữ BCP-47 để hiển thị thông tin người chịu trách nhiệm.Mặc định: Ngôn ngữ của địa chỉ kinh doanh đã đăng ký của seller.Các giá trị có thể:- de-DE- en-IE- es-ES- fr-FR- it-IT

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
messagestringCác thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message.
request_idstringNhật ký yêu cầu
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

Xem các mã lỗi phổ biến

| Code | Message | | --- | --- | | 38023025 | Internal error | | 38023047 | Invalid page size | | 38023048 | Invalid page token | | 38023049 | The number of ids is larger than page size | | 38023050 | Operation is not supported for global seller |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext