抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 代运营
  • 团购退款
  • 商品查询
  • 查询商品模板接口
  • 查询商品草稿数据
  • 查询商品草稿数据列表
  • 查询商品线上数据
  • 查询商品线上数据列表
  • 商品审核结果同步
  • 查询商品品类
  • 资质搜索
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 查询商品草稿数据
    收藏
    我的收藏

    用于查询商品草稿数据。​

    使用限制

    无​

    接口说明

      1.使用商品ID或外部商品ID查询商品草稿​
      2.处于新建审核中、修改审核中、或审核成功、失败、商家确认中的数据可以通过该接口查询到​
      3.服务商只能查询自己通过接口创建的商品信息 自研对于来客上创建的商品数据也可查询​
      4.一次最多查询10个草稿数据​

    基本信息

    HTTP URL
    HTTP Method
    GET
    申请权限
    商品查询​
    权限要求
      需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 ​
      需要商家授权,路径:抖音来客>店铺管理>服务应用授权​

    请求头

    参数
    描述
    必须
    Content-Type
    application/json
    access-token
    根据这个地址获取的token​

    请求参数

    Query 请求

    参数名称
    参数类型
    是否必传
    参数描述
    product_ids​
    string​
    FALSE​
    商品ID列表,多个值使用,拼接​
    商品ID必填,product_ids和out_ids 字段二选一
    out_ids
    string​
    FALSE​
    外部商品ID列表,多个值使用,拼接​
    商品ID必填,product_ids和out_ids 字段二选一
    account_id​
    string​
    TURE​
    商家ID,传入时服务商须与该商家满足授权关系​
    get_draft_type​
    int​
    FALSE​
    【不填默认为 0】​
    0 - 查询平台审核阶段的状态 (状态包括 1、10、11、12)​
    1 - 可额外查询到商家审核阶段的状态(状态包括 1、10、11、12、20、21、22、23、100)​
    草稿状态枚举如下:​
    10-审核中 12-审核失败 1-审核通过 ​
    11-审核通过 20-商家审核中 21-商家拒绝 22-商家成功 23-商家超时 100-上下架/免审成功​

    请求示例

    https://open.douyin.com/goodlife/v1/goods/product/draft/get/?out_ids=test-out-id,test-out-id2&account_id=123123123

    响应参数

    参数名称
    参数类型
    是否必传
    参数描述
    data
    struct​
    TRUE​
    业务参数​
    - product_drafts​
    list < GoodsProductDraft >​
    TRUE​
    草稿列表​
    -- draft_status​
    int​
    TRUE​
    草稿状态 10-审核中 12-审核失败 1-审核通过​
    11-审核通过 20-商家审核中(老库存量数据,新接口保存后擦除)​
    -- audit_msg​
    string​
    FALSE​
    审核失败原因​
    -- product​
    ProductStruct​
    TRUE​
    商品​
    --- product_id​
    string​
    TRUE​
    商品Id,创建时不必填写,更新时如有out_id可不填写​
    --- out_id​
    string​
    TRUE​
    外部商品id​
    --- product_name​
    string​
    TRUE​
    商品名​
    --- category_full_name​
    string​
    FALSE​
    品类全名,保存时不必填写​
    --- category_id​
    int​
    TRUE​
    品类id​
    --- product_type​
    int​
    TRUE​
    商品类型:​
    1 : 团购套餐 3 : 预售券 4 : 日历房 5 : 门票 7 : 旅行跟拍 8 : 一日游 11 : 代金券 12:酒旅新预售 15:次卡​
    --- biz_line​
    int​
    TRUE​
    业务线 1-闭环自研开发者 3-直连服务商 5-小程序​
    --- account_name​
    string​
    TRUE​
    商家名​
    --- sold_start_time​
    int​
    FALSE​
    售卖开始时间​
    --- sold_end_time​
    int​
    FALSE​
    售卖结束时间​
    --- create_time​
    int​
    FALSE​
    创建时间,保存时不必填写​
    --- update_time​
    int​
    FALSE​
    更新时间,保存时不必填写​
    --- out_url​
    string​
    FALSE​
    第三方跳转链接,小程序商品必填​
    --- pois​
    list < PoiStruct >​
    TRUE​
    店铺列表​
    ---- supplier_ext_id​
    string​
    TRUE​
    接入方店铺id,保存时必传​
    ---- poi_id​
    int​
    FALSE​
    poi id,保存时不必填写​
    ---- supplier_id​
    int​
    FALSE​
    店铺id,保存时不必填写​
    --- attr_key_value_map​
    map < string,string >​
    FALSE​
    商品属性KV​
    -- sku​
    SkuStruct​
    TRUE​
    售卖单元​
    --- sku_id​
    string​
    TRUE​
    sku id,创建时不必填写​
    --- sku_name​
    string​
    TRUE​
    sku名​
    --- origin_amount​
    int​
    TRUE​
    原价,团购创建时可不填,会根据商品搭配计算原价​
    --- actual_amount​
    int​
    TRUE​
    实际支付价格​
    --- stock​
    StockStruct​
    TRUE​
    库存信息​
    ---- limit_type​
    int​
    TRUE​
    库存上限类型,为2时stock_qty和avail_qty字段无意义 1-有限库存 2-无限库存​
    ---- stock_qty​
    int​
    TRUE​
    总库存,limit_type=2时无意义​
    ---- avail_qty​
    int​
    TRUE​
    可用库存,limit_type=2时无意义,始终保证stock_qty=avail_qty+frozen_qty+sold_qty​
    ---- frozen_qty​
    int​
    TRUE​
    冻结库存,保存SKU时不填​
    ---- sold_qty​
    int​
    TRUE​
    售卖库存, 退款回滚,保存SKU时不填​
    ---- sold_count​
    int​
    TRUE​
    销量,退款不回滚,保存SKU时不填​
    --- out_sku_id​
    string​
    TRUE​
    第三方id​
    --- status​
    int​
    TRUE​
    状态 1-在线 -1-删除​
    - error_code​
    int​
    TRUE​
    错误码​
    - description​
    string​
    TRUE​
    错误描述​
    extra
    struct
    TRUE
    响应额外信息
    - error_code​
    int​
    TRUE​
    错误码​
    - description​
    string​
    TRUE​
    错误描述​
    - sub_error_code​
    int​
    TRUE​
    (弃用)子错误码​
    - sub_description​
    string​
    TRUE​
    (弃用)子错误描述​
    - now​
    int​
    TRUE​
    (弃用)时间戳​
    - logid​
    string​
    TRUE​
    请求日志ID​

    响应示例

    正常示例

    { "BaseResp": { "StatusCode": 0, "StatusMessage": "" }, "data": { "error_code": 0, "product_drafts": [ { "audit_msg": "", "draft_status": 10, "product": { "creator_account_id": 7107571250087643180, "owner_account_id": 7113893944009705516, "sold_start_time": 1646724999, "telephone": ["1234-4321"], "account_name": "lw测试商家", "pois": [ { "supplier_ext_id": "goods_v1_poi_001", "supplier_id": 7112378515013584941, "poi_id": 6601137575719602180 } ], "attr_key_value_map": { "OrderValidStart": "1638720000", "SortWeight": "0", "real_name_info": "{\"enable\":false,\"scene\":0}", "rec_person_num": "99", "rec_person_num_max": "999", "DateRule": "{\"unavailable_date\":{\"date_list\":[\"2022-03-08\",\"2022-03-09\"],\"weekday_list\":[7,1,2,3,4],\"not_available_on_holidays\":true}}", "Images": "[\"http://tosv.boe.byted.org/obj/aweme-upload-image/7038505021658382380\",\"http://tosv.boe.byted.org/obj/aweme-upload-image/7038505050439696428\"]", "RecommendWord": "推荐语", "description_rich_text": "[{\"note_type\":1,\"content\":\"其他说明信息-美食团购\"}]", "environment_image_list": "[{\"url\":\"http://p-boe-sign.bytedance.net/obj/aweme-upload-image/7038504987084734508?x-orig-authkey=boeorigin&x-orig-expires=1658221200&x-orig-sign=TLe6dfqJ0a7i9VA4Zbh3Cu7qAV8%3D\"}]", "free_pack": "true", "use_date": "{\"use_date_type\":1,\"use_start_date\":\"2021-12-06\",\"use_end_date\":\"2033-03-03\"}", "IndustryType": "其他", "OrderValidEnd": "1993478399", "RefundPolicy": "2", "appointment": "{\"need_appointment\":true,\"external_link\":\"urlxxx\",\"order_appointment_time_url\":\"urlxxx\",\"ahead_time_type\":2,\"ahead_hour_num\":5}", "customer_reserved_info": "{\"allow\":false}", "FrontCategoryTag": "[\"美食套餐\"]", "IsConfirmImme": "true", "can_no_use_date": "{\"enable\":true,\"days_of_week\":[7,1,2,3,4],\"holidays\":[1,2,3,4,5],\"date_list\":[\"2022-03-08\",\"2022-03-09\"],\"holiday_dates\":{\"1\":\"2022.01.01-2022.01.03\"}}", "dishes_image_list": "[{\"uri\":\"aweme-upload-image/7038504987084734508\"}]", "refund_need_merchant_confirm": "true", "SupplierExtIdList": "[\"goods_v1_poi_001\"]", "detail_image_list": "[{\"url\":\"http://p-boe-sign.bytedance.net/obj/aweme-upload-image/7038504987084734508?x-orig-authkey=boeorigin&x-orig-expires=1658221200&x-orig-sign=TLe6dfqJ0a7i9VA4Zbh3Cu7qAV8%3D\"}]", "image_list": "[{\"url\":\"http://p-boe-sign.bytedance.net/obj/aweme-upload-image/7038505021658382380?x-orig-authkey=boeorigin&x-orig-expires=1658221200&x-orig-sign=ygn%2FI0ORgkAJdomj7liPXpK9v3s%3D\"},{\"url\":\"http://p-boe-sign.bytedance.net/obj/aweme-upload-image/7038505050439696428?x-orig-authkey=boeorigin&x-orig-expires=1658221200&x-orig-sign=QGvp6oDAMSW%2F3xA4L7ASboxnYoM%3D\"}]", "show_channel": "2", "superimposed_discounts": "true", "Notification": "[{\"title\":\"标题\",\"content\":\"内容美食1.1\"}]", "TagList": "标签列表-待填写", "private_room": "true", "use_time": "{\"use_time_type\":1}" }, "biz_line": 1, "category_full_name": "美食·地方菜·北京菜", "category_id": 1001001, "product_id": "7119054118261377068", "product_name": "migrate_openapi_0711_03", "out_id": "migrate_openapi_0711_03", "product_type": 1, "sold_end_time": 1745607528 }, "sku": { "origin_amount": 1998, "sku_id": "7119054118261377068", "sku_name": "测试", "status": 1, "stock": { "limit_type": 1, "stock_qty": 500 }, "actual_amount": 996, "attr_key_value_map": { "limit_rule": "{\"is_limit\":true,\"total_buy_num\":9}", "market_price": "900", "settle_type": "1", "use_type": "1", "code_source_type": "1", "commodity": "[{\"group_name\":\"测试0001\",\"total_count\":1,\"option_count\":1,\"item_list\":[{\"name\":\"可乐\",\"price\":1998,\"count\":1,\"unit\":\"份\"}]}]" } } } ], "description": "" }, "extra": { "now": 1658199797, "logid": "202207191103170102251451520001D611", "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "" } }

    错误码

    HTTP 状态码
    错误码
    错误消息
    排查建议
    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
    4000001
    补充参数
    200
    4000002
    对照接口文档规范参数并重试
    200
    5000001
    联系抖音处理