Фильтр датчика

POST
https://daas.digicert.com/apicontroller/v1/certificate/codesigning/filter

Use this endpoint to get the list of codesigning certificates based on the filter criteria selected.

cURL
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/certificates/codesigning/filter' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw 
'{
    "accountId": 5153184,
    "searchCriteriaList": [{
        "key": "status",
        "operation": "EQUALS",
        "value": ["VALID"]
    }],
    "divisionIds": [],
    "startIndex": 1,
    "pageSize": 50,
    "filterSelected": "scanName",
    "sortedColumnId": "thumbprint",
    "sortOrder": "ASC"
}'
200 OK
{
    "error": null,
    "data": {
        "filterName": "scanName",
        "displayName": "Scan name",
        "values": ["AgentscanX", "box64", "crypto", "helloarch", "hhhh", "linuxcore2s20all", "m80winone", "scan0418s10", "scan37linuxnocapi", "scan999", "win93one"]
    }
}

Request parameters

Name Req/Opt Type Description
accountId required string Account ID.
searchCriteriaList optional array Filter results by specified values.
The array includes key, operation and value.
For definitions, see the Filter options for searchCriteriaList table below.
Example: searchCriteriaList:[{"key":"status","operation":"EQUALS","value":["EXPIRED"]}]
divisionIds required array User's division IDs.
startIndex optional integer Index of the first result.
Default1
pageSize optional integer Number of records per page.
Allowed values0 to 512
Default50
filterSelected required string The value to show in the results for each codesigning certificate that meets the search criteria.
Defaultthumbprint
Allowed values: thumbprint, username, ipAddress, divisionName, ipCountry.
sortedColumnId optional string Sort results by specified parameter.
Defaultthumbprint
Allowed values: scanName, status, thumbprint, source, org, ca, serialNumber, filePath, serverHost, tags
sortOrder optional string Sort direction.
Allowed values: DESC (descending: 9-0, Z-A), ASC (ascending: 0-9, A-Z)
Default: DESC

Response parameters

Name Type Description
error object Includes error codes, if any.
data object Object with information about the filter results.
.. filterName string Specified filter key.
.. displayName string Name of the filter key as it appears in the UI.
.. values array List of items that meet the search criteria.
The value shown is the value set for the filterSelected parameter in the request body.

Filter options for searchCriteriaList

The array includes key, operation and value.

Key Operation Value
scanName EQUALS Name of the scan
status EQUALS Status of the scan
org EQUALS Organization name
serialNumber EQUALS Certificate serial number
ca EQUALS Certificate authority
source EQUALS Source used for the scan
serverHost EQUALS Server host associated with the certificate
filePath EQUALS File path from where the certificate is discovered
thumbprint EQUALS Certificate thumbprint