抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 会员通手机号格式说明&国家区号拆分能力
  • 酒店常见枚举值列表
  • 通用错误码
  • 酒店行业日历房解决方案
  • 营销规则价格推送
  • 物理房型上下架能力
  • 主动拉取价量态
  • 营销退出报名
  • 营销价量态拉取
  • 营销规则推送
  • 营销库存推送
  • 日历房线上开票
  • 日历房上下架能力
  • 营销规则价格模式推送
  • 营销查询
  • 入住/离店状态同步能力
  • 日历房交易正向
  • 酒店会员管理
  • 更新酒店会员数据
  • 酒店注销会员
  • 会员信息变更接口通知
  • 会员信息变更(抖音->商家)
  • 抖音请求三方系统发送用户入会通知
  • 酒旅会员-抖音请求三方系统发送用户查询通知
  • 酒旅会员-抖音请求三方系统发送用户退会通知
  • 日历房交易逆向
  • 售卖房型创建/更新能力
  • 物理房型静态信息自助获取能力
  • 房价/房态/房量更新
  • 物理房型静态信息匹配/创建/更新
  • 代理商-酒店静态信息自助获取
  • 酒店日历房接口
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息自助获取能力
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业解决方案
  • 综合
  • 历史版本文档(不推荐)
  • 接口描述

    抖音生活服务调用对接方绑定会员接口进行会员注册或者绑定。
    如果该会员在对接方系统中尚未注册,则对接方需根据请求参数信息进行注册,并返回用户默认初始化信息。
    如果该会员在对接方系统中已经是会员,则返回用户有效会员信息。
    暂时无法在飞书文档外展示此内容

    请求参数

    字段名称
    参数类型
    参数描述
    是否必填
    是否加密
    open_id
    string
    用户唯独的openid,身份唯一标识
    account_id
    string
    商家的账户id
    mobile
    string
    用户手机号
    Y
    name
    string
    中文姓名
    Y
    email
    string
    用户邮箱号
    Y
    id_number
    string
    身份证号
    Y
    first_name_eng
    string
    英文名
    Y
    last_name_eng
    string
    英文姓
    Y
    gender
    int
    用户性别,0:未知,1:女,2:男
    birthday
    string
    用户生日,格式:"yyyy-mm-dd";
    member_card_id
    string
    用户输入的商家会员卡号
    Y

    请求示例

    {"open_id":"f6e35c98-1e53-4943-ad6d-f476f869deab","account_id":"17371731","mobile":"13527153122","name":"James","email":"gC4p5gBnMpKCNouYkLOb30Z335A9JXvMIrIZg4PW9HAPPTAL19I=","id_number":"110","first_name_eng":"","last_name_eng":"","gender":"男","birthday":"2000-01-01","member_card_id":"ijlBlOIuZY+H4oi7qJgyxjwfgebWmFhrUbEB"}

    响应参数

    字段名称
    参数类型
    参数描述
    是否必填
    data
    .error_code
    int
    业务错误码
    0表示成功
    100 表示系统内部处理异常;抖音侧会每天尝试5次重试,直至用户最终入会成功。
    200 表示业务处理失败;抖音侧会记录失败原因,不再重试。
    .description
    string
    错误消息描述
    .open_id
    string
    用户唯独的openid,身份唯一标识
    .user_level
    int
    用户等级
    .point_amount_cent
    int
    积分数量(积分实际数量*100)
    .is_new_member
    bool
    是否全渠道新会员
    .member_card_id
    string
    商家会员卡号
    .room_nights
    int
    房晚(实际数量*100)
    .stay
    int
    用户自注册会员以来入住的总次数(实际数量*100)
    .level_up_nights
    int
    距离下一等级需要的剩余房晚(实际数量*100)
    .level_keep_nights
    int
    保持当前等级需要的剩余房晚(实际数量*100)
    .noshow
    int
    预定而未入住的次数(实际数量*100)
    .effect_end_time
    int(unix_timestamp)
    有效结束时间
    .register_time
    int(unix_timestamp)
    注册时间
    .points_amount_object
    string
    积分、活动积分
    {\"points\":123,\"activity_points\":456}

    同步入会示例

    // 成功示例{"data": {"error_code": 0,"description": "success","point_amount_cent": 1000,"user_level": 1,"is_new_member": false,"open_id": 123,"room_nights": 1000, "member_card_id":"110","effect_start_time": null,"effect_end_time": 1223231273126}}// 错误示例{"data": {"error_code": 211,"description": "业务错误 错误代码211","point_amount_cent": 1000,"user_level": 1,"is_new_member": true}}

    异步入会示例

    // 成功示例,异步入会不要求立即返回会员信息{"data": {"error_code": 0,"description": "success"}}// 错误示例{"data": {"error_code": 100,"description": "system error",}}

    报文示例

    url:https://xxxx req:{"open_id":"_0002A07wmNagm49zVpKf","account_id":"123","mobile":"yx3FZLMB8sK1hmQ2SXQEFA==","name":"","id_number":""} resp:{"data":{"description":"注册成功","error_code":0,"point_amount_cent": 1000,"user_level": 1,"is_new_member": false,"open_id": 123,"room_nights": 1000,"member_card_id":"110","effect_start_time": null,"effect_end_time": 1223231273126}} http code:200 url:https://xxxx req:{"open_id":"_0002A07wmNagm49zVpKf","account_id":"123","mobile":"yx3FZLMB8sK1hmQ2SXQEFA==","name":"","id_number":""} resp:{"data":{"description":"注册成功","error_code":0,"point_amount_cent": 1000,"user_level": 1,"is_new_member": false,"open_id": 123,"room_nights": 1000, "member_card_id":"110","effect_start_time": null,"effect_end_time": 1223231273126}} http code:200