抖音请求三方系统发送用户入会通知
接口描述
抖音生活服务调用对接方绑定会员接口进行会员注册或者绑定。
如果该会员在对接方系统中尚未注册,则对接方需根据请求参数信息进行注册,并返回用户默认初始化信息。
如果该会员在对接方系统中已经是会员,则返回用户有效会员信息。
暂时无法在飞书文档外展示此内容
请求参数
字段名称 | 参数类型 | 参数描述 | 是否必填 | 是否加密 |
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