Description

Retrieve a list of personal completed tasks.

Request Specification

Method: POST + application/json

Endpoint: https://${Cloud Domain}/cgi/crm/v2/special/getTodoDealViewList?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
data	Map	Yes	Dataset
app	String	No	Corresponding BOC category (priority field): ALL: All apps, CRM: All CRM sub-type apps, TASK: Task app
bizType	String	No	Specific business type
appId	String	No	Filter by app ID (returns all if empty)
dealTimeStamp	Long	No	Tasks processed after this timestamp (default: current time)
pageSize	Integer	No	Items per page (default: 20)
lastReadTimeStampMap	Long	No	Last pull timestamp marker (default: server's last stored timestamp)
needStats	Boolean	No	Whether to return task count by business type (default: false)

Request Example

{
  "includeNull": true,
  "data": {
    "app": "hello",
    "lastReadTimeStampMap": 1619712000000,
    "bizType": "hello",
    "appId": "hello",
    "pageSize": 1,
    "needStats": true,
    "dealTimeStamp": 1619712000000
  }
}

Response Parameters

Parameter	Type	Description
traceId	string	Unique request ID
data	List	Dataset
errorDescription	string	Error description
errorMessage	string	Error message
errorCode	Int	Error Codes

Response Example

{
  "traceId": "E-O.827xxxxxx",
  "data": {
    "todoDealViewList":[]
  },
  "errorDescription": "success",
  "errorMessage": "OK",
  "errorCode": 0
}

Notes

• Do not use the message field in the response for logical judgments, as errorMessage may change.