Get Attendance Data List
# Description
Retrieve attendance data list
# Request Specification
Method: POST + application/json
Endpoint: https://${Cloud Domain}/cgi/attendance/find?thirdTraceId=${Random String}
Headers: Refer to Common Parameters
# Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| startTime | Long | Yes | Start timestamp (milliseconds) |
| endTime | Long | Yes | End timestamp (milliseconds); The difference between endTime and startTime cannot exceed 40 days |
| pageSize | Int | No | Page size (default 20, maximum 1000) |
| pageNumber | String | No | Page number (default 1) |
| openUserIds | List | Yes | List of openUserIds for queried personnel; Supports up to 200 users |
# Request Example
{
"pageNumber": 1,
"pageSize": 20,
"startTime": 1479229200000,
"endTime": 1481043600000,
"openUserIds": [
"FSUID_55E332B8B9637C744CFD5FC89F7FCA57"
]
}
# Response Parameters
| Parameter | Type | Description |
|---|---|---|
| traceId | string | Unique request ID |
| errorDescription | string | Error description |
| errorMessage | string | Error message |
| errorCode | Int | Error code |
| datas | List | API response data |
| openUserId | String | User's open platform account |
| userName | String | User nickname |
| createDateStr | String | Check-in date |
| checkTime | Long | Check-in timestamp |
| checkType | Int | Check-in type: 0-check in, 1-check out |
| locationType | Int | Check-in method: 0-coordinates, 1-wifi |
| locationException | Int | Check-in distance: 0-normal, 1-location exception, 2-wifi exception |
| deviceId | String | Check-in device ID |
| checkAddress | Int | Check-in location |
| deviceException | Int | Device exception: 0-normal, 1-exception |
| checkId | Int | Unique data ID |
| systemException | Int | System risk: 0-normal, 1-iOS jailbreak, 2-Android cheating software, 3-Android fake location, 4-emulator, 5-root |
| totalCount | Int | Total record count |
# Notes
- Do not use the message field in the response for logical judgment as errorMessage may change;