简要描述

同步用户信息接口（由MQTT指令syncCards调用）

请求URL

http://{URL}/device/dcit/api/eq/v1/card/sync?t={timestamp}&uuid={uuid}&token={token}&pcode={pcode}&page={page}&pageSize={pageSize}&msgid={msgid}

请求方式

GET

请求参数

参数名类型说明
tstring请求时间戳，精确到秒，时间戳为0为全量更新，其他为增量更新，写在url
uuidstring设备唯一guid，写在url
tokenstringtoken,从登录接口获取，系统校验调用合法用，写在url
pcodestring设备号
pagestring页码（默认 1）
pageSizestring每页行数（默认100 超出丢弃）
msgidstringmqtt消息ID, mqtt中的m[t]字段，写在url

返回参数说明

参数名类型说明最大字节长度是否必须
retCodeint错误码 200-成功;2012-暂无需要同步的数据
是
messagestring错误提示15是
dataobject数据
是
data.totalint所有记录的总数
是
data.timestampstring同步时间戳 精确到秒13是
data.cardsArray数据数组
是
data.data[userId]string用户ID31是
data.data[type]string卡类型 普通卡:CARD 默认CARD8否
data.data[card]string卡号18是
data.data[expired]string门卡过期时间 精确到秒 默认214748364718否
data.data[operation]string操作说明（save，delete，update）8是
data.data[id]string操作ID18否

请求示例

http://{URL}/device/dcit/api/eq/v1/card/sync?t=45421651651621&uuid=xxxxxxxx&token=xxxxxxx&pcode=34011&page=1&pageSize=10&msgid=12518516218521

返回示例

{
 "retCode": 200,
 "message": "ok",
 "data": {
        "total": 10,
        "eField": "1660060800-7841",
        "timestamp": "1548073687",
        "cards": [
                    {
                        "userId":"1",
                        "type":"CARD",
                        "card": "fa905437",
                        "expired": "1579104000",
                        "operation": "save",
                        "id":"123456789"
                    },
                    {
                        "userId":"2",
                        "type":"CARD",
                        "card": "fa905438",
                        "expired": "1579104001",
                        "operation": "delete",
                        "id":"abcdefg"
                    }
                ]
      }
}
  • 无标签