赶知识网

淘宝天猫会员通接口开发文档

2022-07-15 / 955次点击 电子商务

一、品牌商家申请入驻

品牌商品牌会员入驻中心,点击创建应用,在新开页面提交开发者信息。
【企业资质】请上传企业执照副本图片;
【请填写选用的APPKEY 】如果接入方式为自己研发,请填写无,审核同意后需进行创建应用,应用创建成功后自动赋予【品牌会员基础包】(SPI场景组)和【品牌会员积分包】(API权限包)的权限;如果为第三方ISV代开发,联系isv获取应用的AppKey,如果isv应用分前后台,请填写后台AppKey。
ISV无线开放平台
1、开发帐号必须为卖家帐号或者企业资质的帐号。如果是ISV代开发,则ISV需要经过企业资质认证或者由商家申请权限。
2、审核通过后: 应用由ISV提供,【品牌会员基础包】(SPI场景组)和【品牌会员积分包】(API权限包)的权限自动赋予给ISV的应用。

注意事项:
1 品牌商自己研发入驻审核通过以后创建应用。应用标签是--【商家品牌会员】;
2 如果为第三方ISV代开发,isv应该先创建--【新零售会员应用】。在商家申请入驻的时候,商家联系isv获取应用的AppKey,isv提供后台AppKey。

二、开发说明

名词解析

  • SPIService Provider Interface):服务商提供接口,会员中心作为调用方。请求入参在request的body中,返回相应的json格式文本。注意:返回参数以该文档为准

  • TMC:消息通知,会员中心发起的消息通知,主要用于积分变更等重要消息的发送,有重试机制保证消息一定到达。

  • 飞行模式(由平台控制,商家无法进行关闭)

    • 飞行模式1.0(大促时开启):消费者入会请求到阿里平台,不会请求到服务商系统,即服务商是没有此消费者信息的,飞行模式入会后24小时内会进行10次数据回补

    • 飞行模式2.0(日常开启):入会请求返回超时(目前查询要求是1.2s,写(注册,绑定)2s)会触发飞行模式入会,飞行模式入会后24小时内会进行10次数据回补

  • 手机号加密方法

    • 手机号加密方法 加密结果为MD5(MD5("tmall"+$content+$key));加密后的字符串为 32 位小写。tmall 为固定字符串,key 为手机号加密密钥(会员中心开发者后台可见)、content 为需要加密的内容(这里是 moblie)。 代码实例: DigestUtils.md5Hex(DigestUtils.md5Hex("tmall" + "15089990091"+ "abcd")); 先给已存在的手机号做加密运算,然后和平台过来的入会请求里的手机号做匹配,能匹配上则说明线下已存在该手机号,绑定查询接口可返回可绑定

服饰商家开发详见: 会员中心系统接口文档

开发测试过程中商家相关操作见:会员中心-开发者后台(操作说明:点击查看)。

①②③④均为SPI接口,开发者根据接口实现返回json数据即可

① qimen.alibaba.member.activate(会员激活)该接口为全新接口,只有在商家从官方版/定制版切换到会员通时,存量会员从店铺会员点击升级为存量会员时才会用到,详细字段可点击文档,奇门接入可点击文档进行查看

② tmall.mei.crm.member.bind.query(绑定查询)

③ tmall.mei.crm.bind(绑定)

④ tmall.mei.crm.member.register(注册)

如果是java开发,消息用长连接可获取,如果是php需要开发者主动调用接口获取,点击查看消息服务使用介绍,积分变更需订阅消息:tmall_mei_PointChange

1接口名称:tmall.mei.crm.member.sync,线下积分变动通知到阿里,保证线上线下积分一致,详见接口文档

2接口名称:taobao.tmc.messages.consume 消费消息,消息消费后,指针自动后移,下次调用自动获取到未消费过的消息,但是消费确认后的消息无法再次获取。

3接口名称:tmall.mei.crm.callback.point.change,告知阿里服务商系统处理是否成功的结果,一定要确认回调,否则积分变更流程会未完结,进行积分兑券/兑礼的积分会处于冻结中,无法正常使用。注:积分兑礼的礼品签收不代表积分变更流程的完结

4接口名称:taobao.tmc.messages.confirm 确认消息,获取消息后,如果不确认,消息服务会选择时机重发,重发次数由消息服务控制,如果消息3天内都没有被确认将会被删除。


会员通接口开发文档:https://open.taobao.com/docV3.htm?docId=108453&docType=1

 


Top10

沪ICP备09053415号 © 赶知识网