抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 到综团购解决方案
  • 到综团购预约解决方案
  • 综合到店提货解决方案
  • 到综预订解决方案
  • 线索管理解决方案
  • 丽人/汽车/家居家电交易上翻解决方案
  • 零售即送解决方案
  • 零售点单品创建
  • 配送商品创建编辑
  • 查询配送商品线上数据
  • 配送商品列表查询
  • 上下架配送商品
  • 配送商品更新门店
  • 门店SKU库存管理
  • 零售即送配送能力管理
  • 能力
  • 历史版本文档(不推荐)
  • 查询配送商品线上数据

    收藏
    我的收藏

    接口说明

    查询配送商品线上数据

    优先以抖音商品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 状态码错误码错误码描述排查建议
    2002100001
    未知错误
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100004
    系统繁忙,此时请开发者稍候再试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100005
    参数不合法
    请根据接口错误返回信息调整参数
    2002119001
    参数不合法
    请根据接口错误返回信息调整参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2002119010
    接口已下线
    接口已下线
    2002190002
    access_token无效
    调用接口重新生成access_token
    2002190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    2002190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    2005000001
    以实际错误信息为准
    请联系oncall处理
    2003000001
    以实际错误信息为准
    请根据提示排查后重试
    2005000001
    服务器打瞌睡了,请稍后再试。
    请稍后再试