POST Truy vấn tồn kho hàng hóa cho MCF
Truy vấn tồn kho hàng hóa cho MCF Shop Scope yêu cầu: seller.fbt.info Mô tả của [POST]/fbt/:version/query_goods_inventory_for_mcf Phiên bản 202601
POST/fbt/202601/mcf/goods/inventory/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được 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ể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| 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ề response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| goods Required | []object | Các định danh cho hàng hóa được tạo bởi hệ thống Fulfilled by TikTok, độ dài tối đa 50. |
Example
CurlGoNode.jsJavaEnable word wrap
1234567891011curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202601/mcf/goods/inventory/search?timestamp=1623812664&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "goods": [ { "goods_id": "69167899745030" } ]}'
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 response API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"goods_inventory_list":[{"goods_id":"69167899745030","available_qty":10}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi phổ biến
| 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