GET | Consultar ou listar solicitações

Recupera uma ou mais requisições de certificados baseadas em filtros específicos.

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

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`code_request`	`Int`	Não	Código de uma requisição existente. Caso não seja inserido, uma nova requisição será criada.
`status_request`	`Int`	Não	Código do status da requisição.
`type_certificate`	`Int`	Não	Tipo de certificado.
`type_domain`	`String`	Não	Tipo de domínio.
`organization`	`Int`	Não	Código da organização.
`common_name`	`String`	Não	Nome comum do certificado.
`san`	`String`	Não	Nomes alternativos do assunto (separados por vírgula).
`tags`	`String`	Não	Tags de identificação (separadas por vírgula).
`encryption`	`String`	Não	Algoritmo de criptografia.
`encryption_key_size`	`Int`	Não	Tamanho da chave de criptografia.
`algorithm_certified`	`String`	Não	Algoritmo de assinatura.
`validity`	`Int`	Não	Período de validade do certificado em dias.
`environments`	`String`	Não	Ambientes (separados por vírgula).
`systems`	`String`	Não	Sistemas (separados por vírgula).
`design`	`String`	Não	Nome do projeto.
`ip_external`	`String`	Não	Endereço IP externo.
`ip_hostname`	`String`	Não	IP ou hostname.
`responsible`	`Int`	Não	Código do usuário responsável.
`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/certificates/requests?organization=42&limit=10" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Resposta

{
  "status": 200,
  "message": "Requests retrieved successfully",
  "error": false,
  "total": 5,
  "requests": [
    {
      "code_request": 123,
      "status_request": "1 - Pending",
      "type_certificate": 2,
      "type_domain": "SING",
      "organization": 42,
      "common_name": "api.example.com",
      "encryption": "RSA",
      "encryption_key_size": 2048,
      "certificate_algorithm": "SHA256",
      "validity": 365,
      "justification": "Needed for new API service",
      "description": "Certificate for public API endpoints"
    }
    // Additional requests will be listed here
  ]
}