开放接口需要实现的功能
如果主办方使用了API模式进行抽奖程序的对接,则我们需要提供一套API供主办方调用,来实现相关功能。初步整理需要实现的功能如下:
- 要能使用主办方平台的用户身份参与抽奖活动,抽奖页面可以同步头像、昵称和登录的用户身份。
- 必须能使用主办方平台的积分进行抽奖,比如100积分抽奖一次,自动扣除。
- 可以将主办方平台的内容作为奖品并自动发放,比如用户积分、优惠券/现金券、游戏道具等。
- 主办方平台可以自由设定条件给用户奖励抽奖机会,比如首次下载APP、消费满XX元等。
- 主办方可以通过API自动设置抽奖白名单 ,例如将订单号发送到白名单,让用户凭订单号抽奖。
接口设计
为了实现以上功能,需要设计一套接口。接口可以采用 HTTP 的 POST 模式进行通讯。
接口分为两种,一种是抽奖程序的接口,比如给某用户增加抽奖机会的时候,活动方平台就需要主动调用抽奖程序这边的接口给用户增加机会。另外种是活动方平台要开的接口,比如用户抽中了10个金币,抽奖程序就会通过指定接口通知活动主办方的平台,让其给用户发放奖品。初步设计,需要的接口如下:
抽奖程序的开放接口
- 用户注册:主办方平台将首次参与活动的用户信息,通过此API自动注册到抽奖系统中。
- 获得登录标识:主办方在引导用户进入活动页面之前,通过此API获取用户的登录标识,然后附加到活动页面的URL参数中