Data Modification Record Query API
# Description
API for querying data modification records.
# Request Specification
Method: POST + application/json
Endpoint: https://${Cloud Domain}/cgi/crm/v2/object/getNewLogInfoListForWeb?thirdTraceId=${Random String}
Headers: Refer to Common Parameters
# Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| data | Map | Yes | Data map |
| apiName | String | Yes | Object apiName |
| objectId | String | Yes | objectId |
| pageNumber | Int | Yes | Page number |
| pageSize | Int | Yes | Page size |
| operationTimeFrom | Long | Yes | Start time for query |
| operationTimeTo | Long | Yes | End time for query |
| operationalType | String | No | Operation type |
# Request Example
{
"data": {
"apiName": "SPUObj",
"pageNumber": 1,
"operationalType": "system",
"operationTimeTo": "1716998400000",
"pageSize": 20,
"objectId": "xxxxxxxxxxxxxxx",
"operationTimeFrom": "1716825600000"
}
}
# Response Parameters
# Return Value Description
| Field | Type | Remarks |
|---|---|---|
| logID | String | Log ID |
| logMsg | String | Plain text message |
| owner | Object | Owner information |
| └── employeeID | String | Employee ID |
| └── name | String | Name |
| └── profileImage | String | Avatar URL |
| └── department | String | Department |
| └── post | String | Position |
| └── mobile | String | Phone number |
| operationTime | Long | Operation time |
| snapShotType | Int | Snapshot type (0: non-clickable, 1: clickable) |
| operationType | String | Operation type |
| operationLabel | String | Operation type name |
| logDataDetailInfo | Object | Sub-object data |
| └── dataId | String | Data ID |
| └── name | String | Name |
| └── describeApiName | String | API name |
| isDetailFromMaster | Boolean | Whether the modification record is from a sub-object under the main object |
| peerName | String | Source |
| objectInfo | Object | Object data information |
| └── objectApiName | String | Object API name |
| └── objectLabel | String | Object label |
| └── objectDatas | String | Object data |
| msgList | List | Team information changes |
| └── operationLabel | String | Operation type name |
| └── operationType | String | Operation type |
| └── member | String | Member information |
| └── msgMap | String | Change details |
| objectData | List | Data modification records |
| └── fieldApiName | String | Changed field API name |
| └── renderType | String | Field type |
| └── value | Object | New field value |
| └── oldValue | Object | Old field value |
| peerReason | String | Source reason |
| detailInfos | List | Sub-object information |
| └── objectApiName | String | Object API name |
| └── objectLabel | String | Object label |
| masterLogId | String | Main object modification record ID |
| dataName | String | Data primary attribute |
| approvalFlowInfo | Object | Approval flow information |
| └── owner | Object | Personnel information |
| └── operationType | String | Operation type |
| └── operationLabel | String | Operation type name |
| └── objectLabel | String | Object name |
| └── showObjectLabel | String | Whether to display object name (controls display logic) |
# Response Example
{
"logID": "60bd733dedd77500017aa3df",
"owner": {
"employeeID": 1001,
"name": "Liu Dan"
},
"operationTime": 1623028540916,
"snapShotType": 0,
"operationType": "2",
"operationLabel": "Edit",
"objectData": [
{
"fieldApiName": "name",
"renderType": "text",
"value": {
"name": "Beyond the Mountain 222444666"
},
"oldValue": {
"name": "Beyond the Mountain 222444"
}
}
],
"dataName": "Beyond the Mountain 222444666",
"detailFromMaster": false
}
# Notes
- Do not use the message field in the return value for logical judgment, as errorMessage may change.