POST Tìm kiếm Hoàn tất Đơn hàng mẫu của Người bán
Tìm kiếm Hoàn tất Đơn hàng mẫu của Người bán Shop Required scope: seller.affiliate_collaboration.read Bạn, với tư cách là người bán, có thể sử dụng API này để lấy trạng thái hoàn tất của đơn đăng ký mẫu cụ thể và liệu việc hoàn tất đó có dẫn đến đơn hàng hay không. Điều này cho phép Người bán theo dõi tiến độ hiện tại hoặc phân tích kết quả của chương trình phân phối mẫu của họ. Version 202409
POST/affiliate_seller/202409/sample_applications/{application_id}/fulfillments/search
Request
Path
| Properties | Type | Description |
|---|---|---|
| application_id Required | string | Định danh của đơn đăng ký. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán 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 yêu cầu API đến 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. Nhà phát triển có thể sử dụng để 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 yêu cầu API. Nếu không truyền đúng giá trị khi yêu cầu 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 |
|---|---|---|
| content_format | string | Loại nội dung được tạo bởi nhà sáng tạo sau khi nhận được mẫu. Các giá trị enum có thể có: - LIVE- VIDEO |
Example
CurlGoNode.jsJavaEnable word wrap
1234567curl-X POST 'https://open-api.tiktokglobalshop.com/affiliate_seller/202409/sample_applications/123456789/fulfillments/search?timestamp=1623812664&app_key=38abcd&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "content_format": "LIVE"}'
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 thông báo. |
| 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":{"fulfillments":[{"product":{"id":"123456","main_image_url":"https://www.example.com"},"content":{"id":"123456","format":"LIVE","url":"https://www.example.com","view_count":100,"like_count":123,"comment_count":10,"paid_order_count":1,"page_link":"https://www.example.com","description":"abc def gh","create_time":1723529426,"live_end_time":1723529426}}
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Is this content helpful?Helpful
Not Helpful
PreviousNext