抖音开放平台Logo
开发者文档
生活服务商家应用
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 酒店日历房接口
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息自助获取能力
  • 代理商-酒店静态信息自助获取
  • 物理房型静态信息匹配/创建/更新
  • 物理房型静态信息自助获取能力
  • 物理房型上下架能力
  • 售卖房型创建/更新能力
  • 房价/房态/房量更新
  • 酒店会员管理
  • 日历房交易正向
  • 日历房上下架能力
  • 日历房线上开票
  • 入住/离店状态同步能力
  • 营销查询
  • 营销规则价格模式推送
  • 营销规则价格推送
  • 营销价量态拉取
  • 营销价库拉取接口（价格模式SPI）
  • 营销库存推送
  • 营销退出报名
  • 主动拉取价量态
  • 创建及修改佣金计划
  • 修改佣金计划状态
  • 根据商品查佣金计划
  • 根据佣金计划查商品
  • 日历房交易逆向
  • 营销规则推送
  • 度假行业解决方案
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

    抖音侧调用第三方主动拉取营销价量信息。

    基本信息

    Scope
    ​
    权限要求
    ​
    使用场景
    根据服务商提供配置，定时触发

    请求头

    参数名称
    参数类型
    备注
    » Content-Type
    string
    application/json
    X-Bytedance-Logid
    string
    20230808xxxxx2346342
    x-life-clientkey
    string
    服务商应用的 client_key
    X-life-sign
    string
    请求签名，签名规则

    请求体

    参数名称
    参数类型
    必须参数
    备注
    » hotel_ids
    list<string>
    必填
    抖音酒店ID
    » date_range
    object
    必填
    拉取时间范围
    »» end
    string
    必填
    结束日期 eg. 2022-01-04
    »» start
    string
    必填
    开始日期 eg. 2022-01-01

    响应参数

    参数名称
    参数类型
    必须参数
    备注
    data
    struct
    必填
    ​
    » groups
    list<object>
    必填
    营销信息组
    »» rate_plan_id
    string
    必填
    抖音售卖计划ID
    »» promotion_id
    int
    必填
    营销规则ID
    »» date_range
    object
    必填
    时间范围
    »»» end_days
    string
    必填
    结束日期 eg. 2022-01-04
    »»» start_days
    string
    必填
    开始日期 eg. 2022-01-01
    »»» days_of_week
    list<int>
    选填
    指定每周几适用,1~7表示周一至周日
    »» promotion_info
    object
    必填
    营销价格信息
    »»»
    price_member_levels
    list<object>
    必填
    营销后价格
    »»»»bind_member_level
    int
    ​
    选填
    适用的会员等级,如果营销规则设置了会员适用等级，此处必须传入适用的会员等级
    »»»»price
    int
    必填
    营销后价格
    »»» inventory
    int
    必填
    营销库存
    »» sub_error
    string
    选填
    子错误信息
    »» sub_error_code
    int
    选填
    子错误码
    » timestamp
    string
    必填
    秒时间戳，取服务商返回数据时的时间
    » status
    bool
    必填
    状态