Chuyển tới nội dung chính

POST Create Goods

Tạo hàng hóa Shop Scope yêu cầu: seller.fbt.info Mô tả của [POST]/fbt/:version/create_goods Phiên bản 202603

POST/fbt/202603/goods/create_goods

Request

Header

PropertiesTypeDescription
content-type RequiredstringKiểu được phép: application/json
x-tts-access-token RequiredstringGiá 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

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key riêng biệt. Vui lòng sử dụng key cụ thể được gán cho app của bạn.
sign RequiredstringChữ 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ể xác định người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương.
shop_cipher RequiredstringSử dụng property này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu 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

PropertiesTypeDescription
create_goods_dto_list Required[]objectdanh sách create goods dto

Example

CurlGoNode.jsJavaEnable word wrap

1234567891011121314151617181920212223curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202603/goods/create_goods?timestamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "create_goods_dto_list": [ { "tts_sku_id": "723456789012345678", "create_goods_type": "CREATE_AND_BIND", "goods_name": "ABC", "goods_image_url": "https://img0.baidu.com/it/u=3591665277,2616537962&fm=253&app=138&f=JPEG?w=800&h=1333", "reference_code": "ABDK999d", "barcode_infos": [ { "barcode_type": "UPC", "barcode_value": "698888200121" } ], "return_handling_method": "COLLECT_RETURN_UNITS", "dimension_and_weight_base_info": { "weight_value": "1", "length_value": "2", "width_value": "2",

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong response API.
messagestringThô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_idstringNhật ký request
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

{"code":0,"data":{"create_result_info":{"create_result_list":[{"tts_sku_id":"723456789012345678","is_success":false,"tts_goods_id":"9988776655","fail_reason":"success"}]}},"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 logic nghiệp vụ. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext