查询配送商品线上数据
接口说明
查询配送商品线上数据
优先以抖音商品id进行查询(8.31日补充)
使用限制
SLA:支持的最大QPS:10;
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/goods/retailorder/product/detail/ |
| HTTP Method | GET |
| Scope | life.capacity.goods.retailorder.product.detail |
| 权限要求 | 零售SKU(点单品)创建/编辑 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Query
account_id必填Int64
来客商户根账户ID
out_idString
外部商品 id
product_idInt64
抖音商品 id
请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/goods/retailorder/product/detail/?Base={"TrafficEnv":{"Open":false,"Env":"BTyquW06Un"},"Extra":{"xeNhKZqJPy":"A2BxWlv0EM"},"LogID":"3frKAj9AVs","Caller":"grDk8XiKzp","Addr":"eyaFs6YvfZ","Client":"G2stx6vp2D"}&account_id=5260496362915572491&out_id=FZqG1az2Pe&product_id=2708269744963125380' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
BaseRespStruct
展开子属性
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "product_draft": { "product": { "category_id": 6120763989332583000, "test_info": { "test_flag": false, "uid_list": [ "wcAYvuRcuR" ] }, "poi_list": [ { "ext_id": "BkWAbqOofY", "poi_id": 6546968667686481000 } ], "spu_id": 2557676300766443500, "brand": "Xh9OZIip0G", "sku_list": [ { "item_tag_image_list": [ { "uri": "WbDspUguJh", "url": "PAxD8XZpG5" } ], "out_sku_id": "jD2RX3yYe7", "power_rate": { "num": "JFnWQRZSaU", "unit": "v0KkLkC31R", "cal_num": "KO5yMz9gds" }, "sku_weight": { "cal_num": "f5btkwJqvg", "num": "qurRkLSVLj", "unit": "iQPTMbvd6y" }, "outer_package_volume": { "unit": "N2Rs3InIk8", "length": 37311506639268616, "width": 9070518396591343000, "height": 7678998103936464000 }, "sku_69_code": "IkOnx3rNhH", "formula_registration_number": "gNbA9vGfX8", "expire_date": { "expire_type": 1, "shelf_life": { "time": 7421741949681904000, "time_type": 1 }, "expire_date": { "year": 7563909990268583000, "month": 1265792587985800700, "day": 6421969292059428000 } }, "storage_condition": { "is_custom": false, "notes": [ { "content": "H7EIXz7YJv", "note_tags": [ "Z3MCEIqmzq" ], "note_type": 1 } ], "key": 509336472191676350, "value": "wlQV7rcQTS" }, "memory_expansion_capacity": { "value": "BVXWR6enB3", "is_custom": false, "notes": [ { "note_type": 1, "content": "ribZYwxM8y", "note_tags": [ "eghOgotpNX" ] } ], "key": 5727029252333989000 }, "sale_attr_list": [ { "group_code": "P7sN3rzmgI", "item_key": "Ybo7MkB4Fw" } ], "main_material": "GtpKmGWenn", "status": 1, "sku_id": 2840394511826812000, "price": { "actual_amount": 738386539843011700, "origin_amount": 8153675785928876000 } } ], "sale_attr_groups": [ { "group_name": "Tvbbchzacs", "group_code": "VzKH55q8UG", "spec_type": 1, "item_list": [ { "image": { "origin_url": "ijYRKiPsot", "item_info": { "item_id": "kJrRqhALk6", "item_name": "WmEAndRNQW" }, "url": "nlna7nmW3o", "name": "pljXm3x10U", "image_tag": [ "FlH3pqgOZx" ], "log_extra": "1580umNqKv", "quality": { "big_character_score": "83ypnKHlIP", "border_type": "78Sk0GLUNI", "border_score": "1hvZDhj05s", "clarity_score": "yHGXUR37bB", "wholeness_type": "95ds78p9PF", "wholeness_score": "IhzMYw9Qdu", "big_character_type": "mxkic9GqLm", "expire_time": 6527943057540273000, "clarity_type": "MiCknhWTj3" }, "image_type": 1, "uri": "V25fsVQfxo", "origin_uri": "MyyAo6Lvxk", "violation": [ { "source": 1, "code": 2118294536054683000, "message": "RR6JKWiKkW" } ] }, "unit": "jEK4Ax3fwH", "checked": false, "is_default": false, "weight": 7321689527224005000, "item_key": "76vWSeX7z3", "desc_list": [ { "val": "u3bknFNBk5", "key": "0ZHWFZawC9" } ], "add_price": 1329147169457629000, "item_name": "pEOvjfpzyF" } ] } ], "name": "4FKVRcxAME", "out_spu_id": "1cGBo9ZfBj", "description": "tOjjnSI6Eu", "spu_attr_map": { "lFAoGoDunj": "DHIovuqDP5" }, "standard_category_id": 6581617521849701000, "pack_fee": { "pack_fee": 5832030619164473000, "step": 6278857920809524000, "pack_fee_unit": 1 }, "images": { "head_image": { "uri": "eoiBfwi8bY", "url": "zZMdCcTorI" }, "description_image": { "uri": "baNJtKGw24", "url": "2aySOK6NDP" } }, "short_name": "NFOaGs0AWc", "product_id": 4374143750764548600, "account_id": 8928677486746395000, "stock_mode": 1, "out_id": "rvkjy6H31D" }, "draft_status": 1 }, "error_code": 0, "description": "", "product_online": { "status": 1, "product": { "out_id": "nkyFbOwXpA", "out_spu_id": "UjcdBlv2cF", "brand": "FVvkKugUun", "account_id": 5209742995176019000, "product_id": 6187839435987315000, "name": "IKB63mB4FK", "spu_id": 2095812734404941800, "sku_list": [ { "expire_date": { "shelf_life": { "time": 767509079282377600, "time_type": 1 }, "expire_date": { "year": 765460112365483000, "month": 6705197565475447000, "day": 8367756905502776000 }, "expire_type": 1 }, "sku_69_code": "g2jvRjRCPU", "memory_expansion_capacity": { "notes": [ { "content": "bcdDYeYDf0", "note_tags": [ "rzolrQXGkj" ], "note_type": 1 } ], "key": 4473187216982230500, "value": "fZJLCG4kWv", "is_custom": false }, "sale_attr_list": [ { "group_code": "4Vfa9UFJ8B", "item_key": "moTYydtgGi" } ], "formula_registration_number": "Jewb0amdZH", "sku_id": 113554044240512560, "storage_condition": { "is_custom": false, "notes": [ { "note_type": 1, "content": "YgBgtGeJfW", "note_tags": [ "thC6TFZdWh" ] } ], "key": 6010288255607826000, "value": "xO8STX2MvE" }, "status": 1, "outer_package_volume": { "length": 2848473929407329000, "width": 4143499991273539000, "height": 458630690737980300, "unit": "2bqtg7niWb" }, "item_tag_image_list": [ { "url": "zTp0XoaQJs", "uri": "afdI0Ku3Y6" } ], "power_rate": { "num": "37qCtnsvL4", "unit": "69eStDYWXj", "cal_num": "fJfuarAw6O" }, "main_material": "JV96cPFl1r", "out_sku_id": "TYIBVVUqT3", "price": { "actual_amount": 7520749267555359000, "origin_amount": 4612914626485834000 }, "sku_weight": { "num": "Xb4pdghEcu", "unit": "REJtiQf6Em", "cal_num": "pEavwSnzRT" } } ], "images": { "head_image": { "url": "ibhgTnk5kJ", "uri": "q54kJDHDxt" }, "description_image": { "url": "2jf0gTc8q1", "uri": "oxEzbiZrbH" } }, "standard_category_id": 6513121492291852000, "description": "YZoXbAvnN2", "sale_attr_groups": [ { "group_name": "NFTwwr2c6x", "group_code": "ZXkuiPkOS5", "spec_type": 1, "item_list": [ { "unit": "9Cet3aCeHQ", "image": { "item_info": { "item_id": "xvCXVysb27", "item_name": "Sc46ZrQb93" }, "image_tag": [ "4M3XhCkNPV" ], "log_extra": "1OBzbuWtI3", "image_type": 1, "url": "X5lb6BPGDe", "origin_uri": "3IPXOA5piS", "violation": [ { "code": 6818518423865004000, "message": "cksOwjvWm5", "source": 1 } ], "quality": { "border_score": "YusqdKShwo", "clarity_score": "PnwatfMaPZ", "big_character_score": "XEPAjSGdRy", "wholeness_type": "Py8WkOTUEb", "border_type": "7QtmP5e2CX", "wholeness_score": "hui9Ed9N2D", "big_character_type": "BawZBaf88R", "clarity_type": "P9TOyJ3o7J", "expire_time": 9210865402167258000 }, "uri": "1nsERqwD4Z", "origin_url": "r4SQwgMLcr", "name": "pPa2QqoY7B" }, "weight": 5856764631843693000, "item_key": "shegE1LaaO", "item_name": "PwwouIBuc1", "desc_list": [ { "val": "FLl0kZDlfw", "key": "y1jRCrBzXa" } ], "checked": false, "add_price": 4388731846371552000, "is_default": false } ] } ], "test_info": { "uid_list": [ "Dqj7C3F56N" ], "test_flag": false }, "pack_fee": { "pack_fee": 9144504936801789000, "step": 7819348980961969000, "pack_fee_unit": 1 }, "stock_mode": 1, "spu_attr_map": { "N2k4RqCWFA": "9scbcoVdnD" }, "poi_list": [ { "ext_id": "oyA4WJngkg", "poi_id": 2866496804347375000 } ], "category_id": 5374322155250586000, "short_name": "Elo6Uog9Hh" } } }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20260907145518A9A96D461D1EFA06BEBB", "now": 1788764121 }, "BaseResp": { "StatusMessage": "cZpaoscwMJ", "StatusCode": 694951228980550000, "Extra": { "QHJ4Siv1kn": "10WIBCAKLe" } } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 请根据接口错误返回信息调整参数 |
| 200 | 2119001 | 参数不合法 | 请根据接口错误返回信息调整参数 |
| 200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
| 200 | 2119010 | 接口已下线 | 接口已下线 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
| 200 | 3000001 | 根据实际业务错误返 回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 5000001 | 以实际错误信息为准 | 请联系oncall处理 |
| 200 | 3000001 | 以实际错误信息为准 | 请根据提示排查后重试 |
| 200 | 5000001 | 服务器打瞌睡了,请稍后再试。 | 请稍后再试 |
