Retrieves certificate publications based on specified filters.
- Endpoint:
/api/certificate/publish/list
- Method:
GET
- Request:
GET /api/certificate/publish/list
Request parameters
| Parameter |
Type |
Required |
Description |
code_publication |
int |
No |
Publication code. |
code_certified |
int |
No |
Certificate code. |
code_profile_publication |
int |
No |
Publication profile code. |
creation_date |
string |
No |
Publication registration date. |
processed |
int |
No |
Publication processing status. The options are: 1 = Yes and 0 = No. |
error |
int |
No |
Publication error status. The options are: 1 = Yes and 0 = No. |
reason |
int |
No |
Publication reason code. |
itsm_code |
string |
No |
ITSM code. Required if the Governance code required when justifying field is enabled in the certificate access group. |
device |
int |
No |
Publication device code. |
offset |
int |
No |
Pagination starting point. |
limit |
int |
No |
Number of records per page. |
Example using cURL
curl -X GET "https://[segura_vault_url]/api/certificate/publish/list" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Response
{
"status": 200,
"message": "Publications retrieved successfully",
"error": false,
"total": 2,
"publications": [
{
"code_publishing": 567,
"code_certified": 456,
"code_profile_publication": 22,
"creation_date": "2024-01-15",
"processed": "1 - Yes",
"error": "0 - No",
"reason": "3 - Scheduled Renewal",
"itsm_code": "CHG0012345",
"devices": [101, 102, 103]
}
// Additional publications will be listed here
]
}
Error responses
| HTTP Status Code |
Description |
| 400 Bad Request |
Invalid parameters provided. |
| 401 Unauthorized |
Unauthorized access. |
| 403 Forbidden |
Forbidden access. |
| 404 Not Found |
Resource not found. |
| 500 Internal Server Error |
Internal server error. |