点单品查询
接口说明
- 查询点单品信息
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/goods/foodorder/product/detail/ |
HTTP Method | GET |
Scope | life.capacity.ordering.goods.query |
权限要求 | 点单相关商品查询 |
请求参数
请求头
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/foodorder/product/detail/?out_id=vlf2SU6NxL&product_id=40796979178272920&Base={"Extra":{"U7BNauqwZB":"smsbrM1DEV"},"LogID":"SJ1S6xeBDW","Caller":"dYO7UwpaeN","Addr":"cUWBtQCy78","Client":"cIXpfo525J","TrafficEnv":{"Open":false,"Env":"TDjF7qJip9"}}&account_id=2592416282974862159' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
BaseResp必填Struct
公共参数
展开子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
响应数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "BaseResp": { "StatusMessage": "StswOnV3pV", "StatusCode": 3677653057817349000, "Extra": { "ITXQ32EtYT": "wWikEuFM0c" } }, "data": { "error_code": 0, "description": "", "product_online": { "product": { "pack_fee": { "pack_fee": 6480624787882777000, "step": 4182265408090882000, "pack_fee_unit": 1 }, "sku_list": [ { "sale_attr_list": [ { "group_code": "25X9IuUZ43", "item_key": "sq0QEE5Kk8" } ], "out_sku_id": "5KvwrlPibn", "sku_id": 3669097969764364000, "price": { "actual_amount": 7671371748441939000, "origin_amount": 6593821106531358000 }, "status": 1 } ], "out_url": "BdJp1bplDY", "description": "aFSO4jCUP1", "settle_info": { "settle_type": 1 }, "name": "XbuS5zAIw4", "category_id": 2816199318869783000, "sold_time": { "start_time": 6607581789377183000, "end_time": 1447275231445360600 }, "biz_line": 1, "spu_id": 1526340515880509700, "out_id": "lFKWW1PbA2", "sale_attr_groups": [ { "group_name": "x74Ey5cM9g", "group_code": "YJr80FKqcz", "spec_type": 1, "item_list": [ { "image": { "origin_uri": "yduREdILne", "violation": [ { "message": "UH8CR9M8wB", "source": 1, "code": 1491344194495850800 } ], "name": "upU1tx7gHv", "uri": "I1WpxyXtpp", "url": "0aeXLaPnHw", "item_info": { "item_id": "sWFxjGpUUl", "item_name": "lNz4thd2O9" }, "image_type": 1, "image_tag": [ "jWLSBRQ6At" ] }, "checked": false, "item_key": "qFLQKW8Few", "item_name": "WoJ07t06zs", "desc_list": [ { "key": "H2pJ9sePaR", "val": "3NCYEAlu5n" } ], "add_price": 6843830800481353000, "is_default": false } ] } ], "product_id": 9007933294411374000, "images": { "description_image": { "uri": "LtHAe2Qov0", "url": "i1ui0U4KCQ" }, "head_image": { "uri": "nA728rdIzA", "url": "JQodY1Crkb" } }, "poi_list": [ { "ext_id": "Zvfodb6NFP", "poi_id": 251968841509701250 } ], "out_spu_id": "hGftARhmeX", "test_info": { "test_flag": false, "uid_list": [ "t63VAvaKq3" ] }, "account_id": 6810760826820266000, "affiliated_groups": [ { "group_code": "EareLtoXMV", "rank": 2966952451590613000, "out_affiliated_ids": [ "AVsbrvE4nS" ], "group_name": "KvUqB6c50N" } ], "fulfillment_method": [ 1 ] }, "status": 1 }, "product_draft": { "product": { "sale_attr_groups": [ { "group_code": "Ts1MCbpJWs", "spec_type": 1, "item_list": [ { "add_price": 5198127464937893000, "is_default": false, "image": { "origin_uri": "nwnWb19IEW", "violation": [ { "source": 1, "code": 6402793210735741000, "message": "K1pWGSgMbJ" } ], "name": "GB803klfi7", "uri": "R3GU9ySTlQ", "url": "VORY6yll8i", "item_info": { "item_id": "jeglwz7yaS", "item_name": "oey4oXl86z" }, "image_type": 1, "image_tag": [ "pxwRsJ7Abx" ] }, "checked": false, "item_key": "XOJm4DpBlx", "item_name": "t08ES8qS1v", "desc_list": [ { "key": "WeX8G7yvRK", "val": "qRtELXV5UY" } ] } ], "group_name": "BrfglUrW5N" } ], "out_url": "j2vqgP6NjE", "sku_list": [ { "sale_attr_list": [ { "group_code": "iJhoXleUgS", "item_key": "nzZPbUnB5O" } ], "out_sku_id": "5NLuBrY2lV", "sku_id": 6104630785853356000, "price": { "origin_amount": 2782600395162480600, "actual_amount": 4770512016392046000 }, "status": 1 } ], "out_spu_id": "9LWduC11IM", "product_id": 2028959050870484700, "settle_info": { "settle_type": 1 }, "name": "CsKQOiUdSk", "test_info": { "test_flag": false, "uid_list": [ "QQgrNwfD8D" ] }, "description": "V9Ba7TVKZO", "images": { "head_image": { "uri": "oLuZXGYDbW", "url": "v8W6bKlWX2" }, "description_image": { "uri": "Jbcr9ZNwRd", "url": "1BdZeC2YQd" } }, "biz_line": 1, "fulfillment_method": [ 1 ], "out_id": "fuJ1oH2bsP", "poi_list": [ { "ext_id": "b6MyTiyTX2", "poi_id": 2893460029057046000 } ], "category_id": 5301155173834118000, "pack_fee": { "pack_fee": 5858689768772742000, "step": 2712230707274620000, "pack_fee_unit": 1 }, "sold_time": { "start_time": 7650480515565686000, "end_time": 5452404435445974000 }, "affiliated_groups": [ { "out_affiliated_ids": [ "7s5Ow98IFi" ], "group_name": "DFKypp4fNQ", "group_code": "RkF2PMGal5", "rank": 4239431944043916300 } ], "account_id": 270567707365089400, "spu_id": 6023928938268329000 }, "draft_status": 1 } }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2025032517494525BAF305189470314ACC", "now": 1742896185 } }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100005 | 参数不合法 | 更换参数 |
200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
200 | 2119001 | 参数不合法 | 更换参数 |
200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
200 | 3000001 | 以实际错误信息为准 | |
200 | 5000001 | 服务器打瞌睡了,请稍后再试。 |