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
includeNull	Boolean	No	Whether to include null fields. false: not returned, true: returned. Default is false
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

{
  "includeNull": true,
  "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;