适用系统类型:智享版
适用软件版本:无限制
适用商家类型:有自主研发能力的餐饮品牌商户、有服务商支持的餐饮商户
注册成为开发者并登录开发者后台
新建服务-申请接口-提交审核 根据实际需求申请接口,一次性申请所有接口可能审核不通过,审核大概需要1-3个工作日
注意: 未入驻,则按照入驻要求先申请入驻。
(1)点击新建
(2)申请接口
服务名称填写要求: 服务名称在平台唯一,服务名称将会在服务授权时展示、pos上三方券核销入口展示、pos上三方配送入口展示,名称审核后不可修改,故请谨慎命名;
设置回调用地址要求:
开发者设置回调地址后,针对开发者设置的两个回调地址进行验证
第一个验证,会发送【开发者回调地址+?validate=success】这个请求给开发者,请求方式是post,开发者收到后需返回code、message、 messageUuid字段,且code=0, message=成功, messageUuid可自定义才可校验通过。例如: { “code”: 0, “message”: “成功”, “messageUuid”: “3337b6f6-9c95-4992-9fd7-dd7e1e1fc453” }
第二个验证。会发送【开发者回调地址+?validate=fail】这个请求给开发者,请求方式是post,开发者收到后需返回code、message、 messageUuid字段,且code=-1, message=失败, messageUuid可自定义才可校验通过。例如: { “code”: -1, “message”: “失败”, “messageUuid”: “3337b6f6-9c95-4992-9fd7-dd7e1e1fc453” }
(3)提交审核
(4)审核通过(可查看APPKEY,进行门店授权,取消发布后可重新编辑接口)
点击授权二维码-截图给商户扫描授权
线上环境测试用的门店ID/品牌ID供开发者调试接口使用,详细信息如下:
“brandId”: 967381
“shopid”: 87068778、87068779、87068780
账户:18576757054
商家后台密码:123qazQAZ@
掌上客如云密码: 123123
(1)点击授权二维码,截图给商户授权,商户使用微信、掌上客如云、支付宝扫码登录商家后台账号(使用掌上客如云密码)进行授权
注意:
【1】需授权的维度:品牌+门店需商户品牌与门店都需授权
【2】需授权的维度:品牌,则需品牌授权即可
【3】需授权的维度:门店,则需门店授权即可
(2)门店授权完成,可获取token,该token值与通过接口获取的token值一样,通过token,就可以计算请求接口公共参数中的sign值,请求对应的接口数据
已经发布的服务中还需要添加接口,操作步骤如下:
取消发布-申请所需接口-提交审核—客如云审核通过—开发者提供升级授权二维码给商户扫码登录—点击服务升级按钮升级
注:
【1】新添加的接口必须要商户扫描升级二维码进入点击升级才可使用
【2】已发布的服务,取消发布后,不会影响已发布的接口正常使用
钉钉搜索群号“31383957”(客如云API技术支持群-仅限开发入群)
进群的正确方式:请按照"公司名称-在司岗位"格式填写公司名称,在司岗位。【仅限合作方产品(PM)研发(RD)人员申请加入,请按规则设置申请进群】