IPC 会员对接Demo

1 店铺对齐

您可以下载商米助手APP (测试环境的商米助手,会单独提供), 注册并创建商户。 您也可以通过我们的商米数字店铺web(测试版)链接 https://store.uat.sunmi.com/ 进行注册。注册完成之后,您可以

调用

https://store.uat.sunmi.com/openapi/shop/bind

接口将店铺进行对齐,接口所需参数可参考 《商米数字店铺开放平台 -> 商户店铺》

2 设备配网

通过商米助手APP进行FS识客摄像机设备的配网和绑定工作,然后进行进店划线和调焦以保证识别率和准确性。下图为设备配网成功后的状态,指示灯变为蓝色。

在设备完成配置后,您可以在商米助手app或商米数字店铺web端上看到该设备的直播视频以及客流数据

3 设定门店设备人脸分组

接下来您需要对该门店下所有设备配置人脸分组。目前每个门店支持最多十个人脸分组。( 其中包含一个自带的生客分组,一个 自带的熟客 分组 )根据不同的分组信息,不同分组的人进入摄像机的进店区域之后会自动上报信息。在会员场景下,请在调用接口的入参 type 指定为 5.

调用

https://store.uat.sunmi.com/openapi/face/group/create

接口将店铺进行对齐,接口所需参数可参考 《商米数字店铺开放平台 -> 智能摄像机IPC -> 云端API -> 接口文档 -> 第5章》

在成功调用该接口会,您会在返回结果中获得一个 group_id, 作为该分组的唯一标识。

4 录入会员信息

要对会员进行实时识别,您需要首先录入会员信息到平台,建立相应的底库。

调用

https://store.uat.sunmi.com/openapi/member/create

接口将会员信息在我方平台创建,接口所需参数可参考 《商米数字店铺开放平台 -> 智能摄像机IPC -> 会员库》

在接口成功返回之后,您的会员信息即已经录入我方平台。接下来需要把指定的会员信息下发到指定门店的摄像机中。这样在该门店的摄像机上即可以保留相关的特征数据,用来做人脸抓拍后的比对工作。

调用接口

https://store.uat.sunmi.com/openapi/member/assign

接口将会员信息下发到指定门店的摄像机,接口所需参数可参考 《商米数字店铺开放平台 -> 智能摄像机IPC -> 会员库》

在此之后,该会员的记录会添加到门店数据中,在客流数据等场景下都可以体现。您也可以在商米助手app和商米数字店铺web上看到客流统计数据的变化。相关的openAPI接口也都已经开放, 接口将店铺进行对齐,接口所需参数可参考 《商米数字店铺开放平台 -> 智能摄像机IPC -> 云端API -> 接口文档 -> 6人流统计接口》中可以

5 实时到店推送

如果您需要对会员到店的情况,需要获得实时提醒,可以采用消息中心的接口进行订阅。

调用

https://store.uat.sunmi.com/openapi/hook/add

接口可以先订阅您要收到推送的门店以及推送的HTTP地址。事件event选择为2001 .

之后在FS摄像机侦测到会员进店之后,就会实时推送至此订阅的HTTP地址链接。返回的消息大致如下。

{
    "ipc_id": "512369745691",
    "face_id": "235698745612",
    "gender": 1,
    "age_range": 4,
    "group_id": "8927",
    "group_name": "stranger",
    "group_type": 2,
    "member_id": "2938203938",  //如果获取的人员为录入会员,则返回会员id,非会员,则返回为""
}