POST Submit Product via Opportunity
Submit Product via Opportunity Shop Required scope: seller.product.basic Gửi một sản phẩm đã tồn tại (đã được đăng trên TikTok Shop) để phản hồi cho một opportunity lead cụ thể. Sản phẩm sẽ được liên kết với opportunity và đi vào luồng xét duyệt gửi sản phẩm tiêu chuẩn. Nếu bạn cần đăng một sản phẩm mới để đáp ứng opportunity lead, trước tiên bạn phải gọi product release API để tạo product_id , sau đó gửi sản phẩm để liên kết với opportunity lead. Version 202604
POST/product/202604/opportunities/{opportunity_id}/submit
Request
Path
| Properties | Type | Description |
|---|---|---|
| opportunity_id Required | string | Opportunity lead cần phản hồi. |
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 seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
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ể xác định người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng cho tất cả các yêu cầu API. Lập trình viên có thể dùng giá trị 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 giá trị đúng 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 Required | string | ID sản phẩm TikTok Shop cần gửi. Phải ở trạng thái ACTIVATE. |
Example
CurlGoNode.jsJavaEnable word wrap
1234567curl-X POST 'https://open-api.tiktokglobalshop.com/product/202604/opportunities/7123456789012345678/submit?sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&app_key=38abcd&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "product_id": "7298374612938475620"}'
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":{"submission":{"id":"8001234567890123456","opportunity_id":"7123456789012345678","product_id":"7298374612938475620","status":"PENDING_REVIEW","submit_time":1775979270,"rejection_reason":"The submitted product does not match the opportunity"}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
View common error codes
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext