POST Search Goods Info
Tìm kiếm thông tin hàng hóa Shop Scope yêu cầu: seller.fbt.info API này được dùng để truy xuất danh sách hàng hóa thuộc về người bán đáp ứng các điều kiện đã chỉ định. API trả về thông tin chi tiết về hàng hóa, bao gồm ID, tên và các thuộc tính khác, chẳng hạn như mối quan hệ hàng hóa-SKU, kích thước và trọng lượng đã được kho xác minh. Phiên bản 202409
POST/fbt/202409/goods/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 |
|---|---|---|
| page_size Required | int | Số lượng kết quả trả về trên mỗi trang. Phạm vi hợp lệ: [1-100]. |
| page_token | string | Một token mờ (opaque token) dùng để truy xuất trang tiếp theo của tập kết quả được phân trang. Lấy giá trị này từ kết quả next_page_token của một response trước đó. Không cần thiết cho trang đầu tiên. |
| 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 | string | 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 để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | 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ề response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| goods_ids | []string | Định danh cho hàng hóa được tạo bởi hệ thống Fulfilled by TikTok, độ dài tối đa 100. Lọc thông tin hàng hóa để chỉ hiển thị những hàng hóa có goods ID cụ thể.Lưu ý: Khi goods_ids, reference_codes, sku_ids hoặc product_ids bao gồm từ hai giá trị trở lên, kết quả sẽ trả về giao của thông tin hàng hóa. Ví dụ, nếu đầu vào bao gồm cả goods_ids và sku_ids, nó sẽ chỉ trả về những hàng hóa đáp ứng cả tiêu chí goods_ids lẫn sku_ids. Nếu gọi với tất cả các tiêu chí để trống, nó sẽ trả về số lượng hàng hóa bằng page_size do người bán định nghĩa, sắp xếp theo thời gian tạo, mới nhất trước. |
| product_ids | []string | Định danh cho sản phẩm được tạo bởi hệ thống TikTok Shop, độ dài tối đa 100. Lọc thông tin hàng hóa để chỉ hiển thị những hàng hóa có product ID cụ thể. |
| reference_codes | []string | Định danh cho hàng hóa do người bán định nghĩa, độ dài tối đa 100. Lọc thông tin hàng hóa để chỉ hiển thị những hàng hóa có reference code cụ thể. |
| sku_ids | []string | Định danh cho Stock Keeping Unit (SKU) được tạo bởi hệ thống TikTok Shop, độ dài tối đa 100. Lọc thông tin hàng hóa để chỉ hiển thị những hàng hóa có SKU ID cụ thể. |
Example
CurlGoNode.jsJavaEnable word wrap
123456789101112131415161718curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202409/goods/search?shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&page_size=50&page_token=cGFnZV9udW1iZXI9Mg==&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "goods_ids": [ "256080616234" ], "product_ids": [ "256990616123" ], "reference_codes": [ "SELLERSKU 123456" ], "sku_ids": [ "256086568895" ]}'
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 API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. 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":{"next_page_token":"cGFnZV9udW1iZXI9Mg==","total_count":123,"goods":[{"id":"86533997569","name":"water1.0","barcodes":[{"code":"014673829105","type":"UPC"}],"reference_code":"abc32323","image_url":"https://p-boei18n.byted.org/tos-boei18n-i-0euhj0x6u9/beec7f914a044902a0c5dc929b97d064~tplv-k3ldphp9j8-origin-jpeg.jpeg?","merchant_declaration_info":{"weight":{"value":"1.122","unit":"GRAM"},"dimension":{
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | Trống. Không có mã lỗi logic nghiệp vụ. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext