GET | Listar publicações de certificados

Recupera uma ou mais publicações baseadas em filtros específicos.

Endpoint: /api/v1/publications
Método: GET
Requisição: GET /api/v1/publications

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. Valores: 1 = Sim, 0 = Não.
`error`	`Int`	Não	Status de erro da publicação. Valores: 1 = Sim, 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 "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/v1/publications?code_certified=456&limit=10" \
  -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]
    }
    // Additional publications will be listed here
  ]
}

Respostas de erro

Status HTTP	Mensagem de erro
400 Bad Request	Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido).
401 Unauthorized	Credenciais de autenticação inválidas.
403 Forbidden	Permissões insuficientes para baixar o certificado solicitado.
404 Not found	Recurso não encontrado.
409 Conflict	Recurso já existente ou está em um estado incompatível.
500 Internal Server Error	Erro do lado do servidor ocorreu durante o processamento do certificado.