抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 会员通手机号格式说明&国家区号拆分能力
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店行业新预售券解决方案
  • 酒店行业新预售券常见枚举值
  • 酒店静态信息自助获取
  • 酒店会员管理
  • 住宿预售券交易正向
  • 酒旅商品上架和下架信息推送
  • 物理房型静态信息自助获取
  • 物理房型上下架
  • 住宿预售券创建和更新
  • 预售券线上开票
  • 住宿预售券交易逆向
  • 主动拉取价量态
  • 价量态拉取接口
  • 物理房型静态信息匹配/创建/更新
  • 房价/房态/房量更新
  • 酒店静态信息匹配/创建/更新
  • 酒店账单详情查询
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购（在线预约）
  • 景区团购三方码方案
  • 景区行业团购|在线预约解决方案
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

    抖音侧调用第三方主动拉取价量态信息。平台自带精准拉取策略，商家接入后策略自动生效，拉取接口建议至少能提供50QPS。

    基本信息

    Scope
    //WIP
    权限要求
    //WIP
    使用场景
    根据服务商提供配置，定时触发。默认为5分钟。
    为什么要接拉取？
    抖音会从用户触发视角和平台转换视角来做精准拉取，确保价量态的新鲜度
    精准策略
    方案
    备注
    用户访问POI详情页触发拉取
    ​
    ​
    C端->商品->外部商家
    预拉取策略，用户触发
    ​
    可订触发拉取
    ​
    ​
    C端->交易->商品->外部商家
    失败补偿，用户触发
    ​
    热门POI高频拉取
    ​
    ​
    DMP->商品->外部商家
    平台高转化，定时高频触发(top1000poi占大盘40%GMV)
    ​

    请求头

      •Content-Type：application/json
      •X-Bytedance-Logid: 请求 logid， 用于问题排查用
      •x-life-clientkey: 服务商应用的 client_key

    请求体

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

    请求示例

    {
    "hotel_ids": [
        "7643219873621464"
    ],
    "date_range": {
        "start": "2023-01-01",
        "end": "2023-05-01"
    }
}
    ​

    响应参数

    参数名称
    参数类型
    必须参数
    备注
    » status
    bool
    必填
    本次请求是否成功，成功才会更新价量，失败则整个请求的所有价量都会被丢弃
    » errors
    list<string>
    选填
    不成功必填错误信息
    » room_rates
    list<object>
    必填
    价量信息
    »» rate_plan_id
    string
    必填
    抖音售卖计划ID
    »» rate_avail_infos
    list<object>
    必填
    售卖计划的价量信息
    »»» timerange
    object
    必填
    时间范围
    »»»» end
    string
    必填
    结束日期 eg. 2022-01-04
    »»»» start
    string
    必填
    开始日期 eg. 2022-01-01
    »»» length_of_stay
    ​
    int
    ​
    选填
    连住天数。适用于连住（LosRate）场景下，不同连住天数具有单独的连住价格。
      •length_of_stay字段值应大于1，当不传或者值小于等于1时，不会被认定为LosRate模式，而是当作单日价格处理
      •length_of_stay字段值最大不能超过7天
    »»»inventory
    int
    必填
    房量
    »»»available
    bool
    必填
    房态
    »»»original_amount
    int
    选填
    房价（浮动加价时必填价格，否则会日历价格会被清除）
    支持传0和-1，表示清除价格
    »»» fplos
    ​
    string
    ​
    选填
    fplos=“0111011”，则表示允许连住2天,3天,4天,6天,7天；但是不允许连住1天,5天；
      •抖音支持最长传入14天
      •fplos中只要有“1”存在，那么总房态available就应该置为true
    »»»los_rate_break_down
    ​
    list<object>
    ​
    选填
    连住模式下单日价格明细列表
      •列表长度需要和length_of_stay的值相等
      •按列表顺序设定每天价格，即当length_of_stay = 3时，los_rate_break_down[0]为第一天的价格，los_rate_break_down[1]为第二天的价格，依此类推。
    »»»»day_original_amount
    int
    选填
    单天售卖原价
    ​
    »»»»day_amount_before_tax
    int
    选填
    单天售卖税前价
    »» sub_error
    string
    选填
    子错误信息
    »» sub_error_code
    int
    选填
    子错误码
    » timestamp
    string
    必填
    秒时间戳，取服务商返回数据时的时间

    响应示例

    {
    "room_rates": [
        {
            "rate_plan_id": "723587692345234534",
            "rate_avail_infos": [
                {
                    "timerange": {
                        "start": "2023-01-01",
                        "end": "2023-05-01"
                    },
                    "length_of_stay": 1,
                    "original_amount": 10000,
                    "available": true,
                    "inventory": 20
                }
            ],
            "status": true,
            "sub_error": "售卖计划ID错误",
            "sub_error_code": 60021
        }
    ],
    "timestamp": "17346834298",
    "status": true,
    "errors": [
        "错误"
    ]
}
    ​
    ​
    ​