【会员相关接口】八大场景接口对接说明

一、场景说明

首先明确几个概念：

       粉丝：有赞没有统一的流量入口，消费者都是从不同的渠道进入有赞，比如微信、微博、APP等，有赞通过粉丝类型即fans_type去标识这些渠道，通过静默授权等方式，有赞拿到不同渠道账号体系对应的用户ID，生成有赞的粉丝ID即fans_id，粉丝ID是粉丝的唯一标识；

       客户：粉丝在微商城中主动绑定了手机号，即成为微商城的客户；或者买家通过普通的链接或扫描二维码等方式进入微商城，下单时绑定手机号，也会成为微商城的客户；微商城客户以手机号作为用户标识，并具有唯一的客户ID；

       会员：商家在微商城创建会员卡，将会员卡发放给粉丝或客户，或者粉丝和客户主动领取会员卡，即成为该微商城的会员；

       本文档主要介绍了外部系统和有赞微商城对接时，如何打通会员信息及会员附带的一些基础权益，如优惠券、积分等；需要注意的是，会员数据打通之前需要双方约定好会员规则，会员规则一致才可以打通。会员数据对接主要涉及的接口有客户创建接口、商家创建会员卡、给用户发放会员卡、获取商家会员卡列表、会员卡对应的会员列表、创建优惠券、发放优惠券优惠码、核销优惠券优惠码、给用户加积分、给用户减积分、全量同步用户积分等。

二、七大场景API接口及调用说明

• 场景一：客户信息同步
• 场景二：会员信息同步
• 场景三：会员卡及会员信息管理
• 场景四：优惠券同步
• 场景五：优惠券核销
• 场景六：积分同步
• 场景七：积分增加、扣减
• 场景八：会员信息变更有赞主动推送
  

三、使用API接口调试工具排查问题

        调用有赞API接口出现问题时，可以使用API接口调试工具对调用参数进行检查，以此来确认是否是调用参数的问题。

       API调试工具地址：https://www.youzanyun.com/docs/debugger ；

       调试工具调用示例：获取用户积分