Interface Description
Interface for querying driver's clock- in record details
Request Example
https://v7.cmsv8.com/StandardApiAction_queryPunchCardRecode.action?jsession=66d754dd7f41473dbd2&vehiIdno=S66666&begintime=2024-12-01 00:00:00&endtime=2024-12-05 23:59:59&toMap=0¤tPage=1&pageRecords=10
Request Parameters
| Parameter name |
Parameter type |
Required or not |
Example |
Description |
| jsession |
string |
Yes |
66d754dd7f41473dbd2 |
Session number |
| vehiIdno |
string |
No |
S66666 |
License plate number; can be multiple, divided.License plate number; can be multiple, divided. (If the license plate number is blank, all authorized vehicles of the account number will be queried) |
| dids |
string |
No |
0 |
Driver ID; can be multiple, split. |
| begintime |
string |
Yes |
2024-12 01 00:00:00 |
Start Time |
| endtime |
string |
Yes |
2024-12-05 00:00:00 |
End time: start time to end time cannot exceed 3 months |
| toMap |
string |
No |
0 |
Map coordinate conversion: 0 means WGS84 coordinates; 1 means Google coordinates (gj02);2 means Baidu coordinates (bd09) |
| geoaddress |
string |
No |
|
Whether to resolve geographical location; 1 indicates that if the service of resolving geographical location is provided, the geographical location will not be resolved. |
| currentPage |
string |
No |
1 |
The page number of the current query; if empty, no paging. |
| pageRecords |
string |
No |
10 |
Number of pages; if empty, no page breaks. |
Return Parameter
| Parameter Name | parameter Type | meaning of parameters |
|---|
| result | number | 0 indicates success, others indicate failure, [error code description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1321&type=1&lang=en "error code description") |
| pagination | string | |
| infos | array | |
| guid | string | alarm Unique Number |
| vid | number | vehicle ID |
| vehi | string | license plate number |
| cnm | string | company Name |
| dev | string | equipment No. |
| stm | number | alarm Start Time (UTC) Seconds |
| etm | string | alarm End Time (UTC) Seconds |
| atp | number | alarm Type |
| info | number | alarm information |
| p1 | number | for details of alarm parameter 1, see [Alarm parameter description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1324&type=1&lang=en "Alarm parameter description"). |
| p2 | number | for details of alarm parameter 2, see [Alarm Parameter Description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1324&type=1&lang=en "Alarm Parameter Description"). |
| p3 | number | for details of alarm parameter 3, see [Alarm parameter description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1324&type=1&lang=en "Alarm parameter description"). |
| p4 | number | for details of alarm parameters, see [Alarm Parameter Description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1324&type=1&lang=en "Alarm Parameter Description"). |
| desc | string | the punch- in information is divided. Driver Name | Issuing Authority | ID Card Number | Qualification Certificate Code|Validity period of driver's license |
| ss1 | number | alarm start status 1 See for details: [Alarm Status Description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1326&type=1&lang=en "Alarm Status Description") |
| ss2 | number | alarm start state 2 See for details: [Alarm state description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1326&type=1&lang=en "Alarm state description") |
| ES1 | string | for details of the alarm end status 1, see [Alarm Status Description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1326&type=1&lang=en "Alarm Status Description"). |
| ES2 | string | for details of the alarm end status 2, see [Alarm Status Description](https://help.cmsv8.com/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1326&type=1&lang=en "Alarm Status Description"). |
| slng | number | alarm start longitude |
| slat | number | alarm start latitude |
| elng | string | alarm end longitude |
| elat | string | alarm End Latitude |
| smlat | string | the converted latitude of the alarm start map latitude |
| emlat | string | the converted latitude of the map after the alarm ends |
| sps | string | the geographical location of the alarm start geographical location or (the longitude of the alarm start map, the latitude of the alarm start map) |
| eps | string | the geographical location after the end start geographical location resolution or (longitude of the alarm end map, latitude of the alarm end map) |
| ddinfo | string | name of punch- in driver |
| issu | string | card driver issuing authority |
| idCard | string | pin- in driver ID number |
| cert | string | card driver qualification certificate |
Return Example
{
"result": 0,
"pagination": null,
"infos": [
{
"guid": "1CDA85787D8B4E1B9E37B3BC88BC81E7",
"vid": 1,
"vehi": "S66666",
"cnm": "ces",
"dev": "013300000001",
"stm": 1733105086000,
"etm": null,
"atp": 442,
"info": 0,
"p1": 6,
"p2": 2,
"p3": 0,
"p4": 1,
"desc": "text;bjjtt;;111111;2027-12-01;",
"ss1": -2145374847,
"ss2": 528384,
"es1": null,
"es2": null,
"slng": 113697950,
"slat": 22992274,
"elng": null,
"elat": null,
"smlat": "22.992274,113.697950",
"emlat": null,
"sps": "22.992274,113.697950",
"eps": "",
"ddinfo": "text",
"issu": "bjjtt",
"idCard": "",
"cert": "111111"
}
]
}
