POST Seller Review Sample Applications
Đánh giá đơn xin mẫu của người bán Shop Required scope: seller.affiliate_collaboration.write API này cho phép người bán phê duyệt hoặc từ chối đơn xin mẫu của nhà sáng tạo trong một hợp tác mở. Khi từ chối một đơn, người bán phải cung cấp lý do cụ thể. API này hỗ trợ việc quản lý các đơn xin mẫu bằng cách cho phép người bán đánh giá và cập nhật các đơn theo tiêu chí và yêu cầu của mình. Version 202507
POST/affiliate_seller/202507/sample_applications/{application_id}/review
Request
Path
| Properties | Type | Description |
|---|---|---|
| application_id Required | string | ID duy nhất của đơn xin mẫu |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán lấy từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗ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 Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể xác định người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Lập trình viên có thể dùng cái này để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| review_result Required | string | Hành động kiểm duyệt cần thực hiện đối với một bản ghi đơn xin mẫu bởi người bán. Trường này chấp nhận một trong bốn giá trị liệt kê:- APPROVE: Phê duyệt đơn xin mẫu.- REJECT: Từ chối đơn xin mẫu.Trường này cho phép người bán chỉ định thao tác mong muốn để quản lý bản ghi đơn xin mẫu một cách hiệu quả. |
| reject_reason | string | Lý do tại sao người bán từ chối đơn xin mẫu của nhà sáng tạo. Các giá trị liệt kê có thể có là:- NOT_MATCH: Nhà sáng tạo không đáp ứng yêu cầu hợp tác của người bán.- OFFLINE: Sản phẩm đã được gỡ khỏi cửa hàng.- OUT_OF_STOCK: Sản phẩm tạm thời hết hàng.- OTHER: Bất kỳ lý do nào khác không thuộc các nhóm trên.Bắt buộc nếu review_result được đặt thành REJECTTrường này cho phép người bán chỉ định lý do từ chối một đơn xin mẫu, giúp nhà sáng tạo hiểu rõ về việc từ chối. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678curl-X POST 'https://open-api.tiktokglobalshop.com/affiliate_seller/202507/sample_applications/8070747592760922552/review?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "review_result": "APPROVE", "reject_reason": "NOT_MATCH"}'
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | 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_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
View common error codes
| Code | Message | | --- | --- | | 16022020 | seller has no permission to operate agency's sample request |
Is this content helpful?Helpful
Not Helpful
PreviousNext