Retrieves one or more certificate publications based on specified filters.
- Endpoint:
/api/v1/publications
- Method:
GET
- Request:
GET /api/v1/publications
Request parameters
| Parameter |
Type |
Required |
Description |
code_publication |
Integer |
No |
Publication code. |
code_certified |
Integer |
No |
Certificate code. |
code_profile_publication |
Integer |
No |
Publication profile code. |
creation_date |
String |
No |
Publication registration date. |
processed |
Integer |
No |
Publication processing status. Values: 1 = Yes, 0 = No. |
error |
Integer |
No |
Publication error status. Values: 1 = Yes, 0 = No. |
reason |
Integer |
No |
Publication reason code. |
itsm_code |
String |
No |
ITSM code text. |
device |
Integer |
No |
Publication device code. |
offset |
Integer |
No |
Pagination starting point. |
limit |
Integer |
No |
Number of records per page. |
Example using cURL
curl -X GET "https://[segura_vault_url]/api/v1/publications?code_certified=456&limit=10" \
-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 |
Description |
| 400 Bad Request |
Invalid parameters or missing required fields. |
| 401 Unauthorized |
Invalid or expired authentication token. |
| 403 Forbidden |
Insufficient permissions to access the resource. |
| 404 Not Found |
The requested resource does not exist. |
| 409 Conflict |
Resource already exists or is in an incompatible state. |
| 500 Internal Server Error |
Unexpected server-side error. |