酒旅会员-抖音请求三方系统发送用户入会通知

我的收藏

接口描述

抖音生活服务调用对接方绑定会员接口进行会员注册或者绑定。

如果该会员在对接方系统中尚未注册，则对接方需根据请求参数信息进行注册，并返回用户默认初始化信息。

如果该会员在对接方系统中已经是会员，则返回用户有效会员信息。

暂时无法在飞书文档外展示此内容

请求参数

字段名称	参数类型	参数描述	是否必填	是否加密
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