POST Create Goods
Create Goods Shop Required scope: seller.fbt.info Description of [POST]/fbt/:version/create_goods Version 202603
POST/fbt/202603/goods/create_goods
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| create_goods_dto_list Required | []object | create goods dto list |
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\u0026fm=253\u0026app=138\u0026f=JPEG?w=800\u0026h=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
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
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
View common error codes
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext