GET | Listar publicações de certificados

Recupera publicações de certificados baseadas em filtros específicos.

Endpoint: /api/certificate/publish/list
Método: GET
Requisição: GET /api/certificate/publish/list

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`code_publication`	`int`	Não	Código da publicação.
`code_certified`	`int`	Não	Código do certificado.
`code_profile_publication`	`int`	Não	Código do perfil de publicação.
`plugin_type`	`string`	Não	Filtra publicações por tipo de plugin.
`profile_name`	`string`	Não	Filtra publicações pelo nome do perfil de publicação. Aceita correspondências parciais.
`creation_date`	`string`	Não	Data de registro da publicação.
`processed`	`int`	Não	Status de processamento da publicação. As opções são: 1 = Sim e 0 = Não.
`error`	`int`	Não	Status de erro da publicação. As opções são: 1 = Sim e 0 = Não.
`reason`	`int`	Não	Código de motivo para assinatura. Deve haver um código de motivo válido na Segura®.
`itsm_code`	`string`	Não	Código ITSM. Obrigatório se o campo Código de governança obrigatório ao justificar estiver habilitado no grupo de acesso do certificado.
`device`	`int`	Não	Código de publicação do dispositivo.
`offset`	`int`	Não	Ponto de início da paginação.
`limit`	`int`	Não	Número de registros por página.

Exemplo utilizando cURL

curl -X GET "https://[segura_vault_url]/api/certificate/publish/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Resposta

{
  "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",
      "plugin_type": "F5 Big-IP",
      "profile_name": "Production-F5-01",
      "devices": [101, 102, 103]
    }
    // Publicações adicionais serão exibidas aqui.
  ]
}

Info

Os campos plugin_type e profile_name retornam null quando não há um perfil de publicação associado à publicação.

Respostas de erro

Código de status HTTP	Descrição
400 Bad Request	Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido). Isso inclui um valor inválido para o filtro `plugin_type` (código de erro `1076`) ou para o filtro `profile_name` (código de erro `1077`).
401 Unauthorized	Acesso não autorizado.
403 Forbidden	Permissão negada.
404 Not Found	Recurso não encontrado.
500 Internal Server Error	Erro interno do servidor.