GET | Listar uma publicação de certificado

Prev Next

Lista uma publicação de certificado baseada em filtros específicos.

  • Endpoint: /api/certificate/publish/list/{{id_publicacao}}
  • Método: GET
  • Requisição: GET /api/certificate/publish/list/{{id_publicacao}}

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.
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/1" \
  -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",
      "devices": [101, 102, 103]
    }
  ]
}

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).
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.