POST Seller Search Sample Applications
Tìm kiếm đơn đăng ký mẫu của người bán Shop Scope yêu cầu: seller.affiliate_collaboration.read API này được cung cấp cho người bán để truy vấn các đơn đăng ký mẫu dựa trên nhiều tiêu chí khác nhau như sản phẩm, nhà sáng tạo hoặc trạng thái đơn đăng ký. Bằng cách sử dụng API này, người bán có thể truy xuất thông tin chi tiết về các bản ghi đơn đăng ký mẫu, bao gồm thông tin của nhà sáng tạo và các chi tiết cụ thể của từng đơn đăng ký. Version 202508
POST/affiliate_seller/202508/sample_applications/search
Request
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ể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trong tất cả các yêu cầu API. Nhà phát triển có thể sử dụng giá trị này để chuyển đổi sang giờ địa phương. |
| page_token | string | Offset phân trang xác định nơi bạn bắt đầu tìm kiếm. Nó để trống khi bạn gửi yêu cầu đầu tiên. |
| page_size | int | Giá trị của "page_size" phải lớn hơn 0 và nhỏ hơn hoặc bằng 50. |
| 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 |
|---|---|---|
| product_id | string | Định danh duy nhất của một sản phẩm. Nó được dùng để chỉ định chi tiết đơn đăng ký mẫu của sản phẩm nào đang được truy vấn. |
| title | string | Tên sản phẩm, hỗ trợ truy vấn tìm kiếm mờ. Nó cho phép người bán tìm kiếm sản phẩm theo tên khi quản lý đơn đăng ký mẫu. |
| creator_user_oepn_id | string | TikTok User ID của một nhà sáng tạo |
| username | string | TikTok User Name của một nhà sáng tạo, hỗ trợ tìm kiếm mờ |
| target_collabration_id | string | ID duy nhất được tạo sau khi tạo một target collaboration. |
| order_id | string | ID đơn hàng chính liên kết với một đơn hàng mẫu khi đơn đăng ký mẫu được người bán phê duyệt. |
| status | string | Trạng thái của các đơn đăng ký mẫu. Các giá trị liệt kê có thể có là:- PENDING: Đơn đăng ký mẫu đang chờ người bán xét duyệt.- AWAITING_SHIPMENT: Đơn đăng ký đã được phê duyệt và người bán cần gửi mẫu.- SHIPPED: Mẫu đã được người bán gửi và đang chờ nhà sáng tạo nhận gói hàng.- CONTENT_PENDING: Nhà sáng tạo đã nhận gói hàng mẫu và dự kiến tạo nội dung.- REJECT_CANCELLED: Đơn đăng ký mẫu đã bị người bán từ chối.- OVERDUE_CANCELLED: Đơn đăng ký mẫu đã hết hạn do quá hạn.- UNFULFILL_CANCELLED: Nhà sáng tạo không thực hiện cam kết tạo nội dung trong khung thời gian đã thỏa thuận.- DEL_OPEN_COLLAB: Open collaboration đã bị xóa.- SELLER_NOT_SHIP_CANCELLED: Người bán không gửi mẫu trong khung thời gian yêu cầu.- WITHDRAW_CANCELLED: Nhà sáng tạo đã rút đơn đăng ký mẫu trước khi người bán phê duyệt.- UNFULFILLABLE_CANCELLED: Đơn đăng ký bị hủy do các lý do nằm ngoài tầm kiểm soát của nhà sáng tạo, khiến việc tạo nội dung không thể thực hiện.- OPS_CANCELLED: Đơn đăng ký bị hủy thủ công bởi nhân viên vận hành.- OPS_FAILED: Đơn đăng ký bị đánh dấu là thất bại bởi nhân viên vận hành.- OPS_COMPLETED: Đơn đăng ký được đánh dấu thủ công là hoàn thành bởi nhân viên vận hành.- COMPLETED: Đơn đăng ký hoàn tất và nhà sáng tạo đã đăng nội dung.Trường này cho phép theo dõi trạng thái của một đơn đăng ký mẫu trong suốt vòng đời của nó, cung cấp khả năng quan sát từng giai đoạn của quy trình cho người bán và nhà sáng tạo. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678910111213curl-X POST 'https://open-api.tiktokglobalshop.com/affiliate_seller/202508/sample_applications/search?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&page_token=b2Zmc2V0PTAK&page_size=50' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "product_id": "123456", "title": "product name", "creator_user_oepn_id": "123456", "username": "test_tt_name", "target_collabration_id": "123456", "order_id": "123456", "status": "PENDING"}'
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":{"next_page_token":"aDU2dHIzMlFhME5CUzJKUDhDdVJhTDM1WmJkeFVTVW9LTkRaSnNaZCtuWjJXVU5CSDhlaA==","total_count":100,"sample_applications":[{"id":"123456","commission_rate":"0.1","status":"PENDING","order_id":"123456","available_quantity":50,"approve_expiration_time":1728674995,"shipment_expiration_time":1728674995,"tracking_number":"123456","fulfillment_status":"ONGOING","is_approvable":true,"disapprovable_reasons":["Product out of stock"],"partner_name":"ABC","creator":{"creator_open_id":"uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg",
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. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext