GET Lấy bản ghi gửi
Lấy bản ghi gửi Shop Scope yêu cầu: seller.product.basic Truy xuất danh sách phân trang các bản ghi gửi cho seller đã được ủy quyền, bao gồm trạng thái gửi, kết quả xét duyệt và thông tin opportunity/product được liên kết. Hữu ích để theo dõi lịch sử gửi và giám sát kết quả xét duyệt. Phiên bản 202604
GET/product/202604/opportunities/submissions
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 tới 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 dùng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| status | string | Lọc theo trạng thái gửi: PENDING_REVIEW / APPROVED / REJECTED. Để trống để trả về tất cả trạng thái. |
| opportunity_id | string | Lọc theo opportunity ID cụ thể. |
| product_id | string | Lọc theo product ID cụ thể. |
| submit_time_ge | int | Lọc các bản gửi được tạo sau thời điểm này, timestamp cấp giây |
| submit_time_lt | int | Lọc các bản gửi được tạo trước thời điểm này, timestamp cấp giây |
| page_token | string | Token phân trang từ phản hồi trước đó. Bỏ qua cho trang đầu tiên. |
| page_size Required | int | Số kết quả trên mỗi trang. Tối đa: 100. Mặc định: 20. |
| shop_cipher Required | string | Sử dụng property 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 |
Example
CurlGoNode.jsJavaEnable word wrap
1234curl-XGET 'https://open-api.tiktokglobalshop.com/product/202604/opportunities/submissions?page_size=20&status=APPROVED&product_id=7298374612938475620&submit_time_ge=1775973876&page_token=100&opportunity_id=7123456789012345678&submit_time_lt=1776973876&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'
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":{"data":{"submissions":[{"id":"8001234567890123456","opportunity_id":"7123456789012345678","opportunity_title":"Women's High-Waist Yoga Leggings","status":"APPROVED","product_id":"7298374612938475620","product_name":"Premium Yoga Leggings - Black","submit_time":1775973876,"review_time":1775973876,"rejection_reason":"Product does not match the opportunity category requirements","product_orders":121,"product_pv":320}],"next_page_token":"100","total_count":300}},
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | Trống. Không có mã lỗi nghiệp vụ. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext