查询签到记录 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/sign/v1/getSignList?accessToken=

Content-Type: application/json

用于批量查询签到记录;

不传入查询时间时，默认查询近一周的签到数据;

分页返回，第一页为查询范围内最早的数据;

接口限制：每分钟调用600次；

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

请求参数名	类型	说明	是否必须
beginTime	`Int`	查询日期起始时间区间（不填写默认查询近一周，最大支持查询1个月）。秒时间戳，如：1656604800	false
endTime	`Int`	查询日期结束时间区间（不填写默认查询近一周，最大支持查询1个月）。秒时间戳，如：1656604800	false
uid	`String[]`	签到员工id，支持传入多个。为空为查询全部员工签到记录。使用尘锋员工的uid	false
signType	`String`	签到类型，为空为查询全部类型，"stranger"= 陌生拜访; "contact"=客户签到; “company” = 企业签到	false
status	`Int`	0=正常签到;1=异常签到; -1=全部签到	false
page	`Int`	当前页码,起始页：1	true
pageSize	`Int`	分页大小，最大值：500	true

JSON-请求示例

{
    "beginTime": 1698163200,
    "endTime": 1698422400,
    "page": 1,
    "pageSize": 20,
    "signType": "contact",
    "status": -1,
    "uid": [
        "173"
    ]
}

成功响应

响应参数名	类型	说明
success	`Bool`	请求状态，true：成功，false：失败_Allowed values: true,false_
trace_id	`String`	操作日志id
msg	`String`	消息提示
data	`Object`	数据信息
data.list	`Object[]`	数据信息
data.list.addressDetail	`String`	签到地点
data.list.longitude	`Double`	签到地点 - 经度
data.list.latitude	`Double`	签到地点 - 纬度
data.list.distance	`Int`	签到距离(m)
data.list.createTime	`String`	签到时间
data.list.remark	`String`	签到备注
data.list.photos	`Object[]`	图片信息
data.list.photos.name	`String`	图片名称
data.list.photos.url	`String`	图片地址获取附件URL访问签名
data.list.signType	`String`	签到类型
data.list.status	`String`	签到状态
data.list.cid	`String`	关联联系人id
data.list.corpId	`String`	关联企业id
data.list.uid	`String`	签到员工id

成功响应示例

{
    "code": 0,
    "data": {
        "list": [
            {
                "addressDetail": "xxxxxxxx",
                "cid": "3acf855e-6806-11ee-8711-8a0fa802f5cd",
                "corpId": "",
                "createTime": "2023-10-26 14:10:45",
                "distance": 30,
                "id": "668b39be-73c6-11ee-a7cc-5695cd4cad07",
                "latitude": 30.549006,
                "longitude": 104.066406,
                "photos": [
                    {
                        "name": "0b09f5bf-8c10-4937-b9eb-2a5c3a1c5bdb",
                        "url": "https://xxxxx"
                    }
                ],
                "remark": "签到备注",
                "signType": "contact",
                "status": "0",
                "uid": "173"
            }
        ]
    },
    "msg": "OK",
    "success": true,
    "traceId": "a8bd244c-6890-9a0e-b984-0b028937afe3"
}

错误响应示例

{
    "code": 20060023,
    "data": {},
    "msg": "签到时间参数超过最大跨度",
    "success": false,
    "traceId": "b4a407a6-5f29-984e-ad87-7382c257c86e"
}