GET | Listar requisições

Prev Next

Lista requisições de certificados baseadas em filtros específicos.

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

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/certificate/request/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Resposta

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "1001: OK",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "1001: OK",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "data": {
        "code_request": "1",
        "status_request": "7 - Signed",
        "type_certificate": "DV SSL - Domain SSL",
        "type_domain": "Single domain",
        "organization": "organization",
        "common_name": "api-test.com",
        "san": "api-test",
        "tags": "",
        "validity": "100",
        "encryption": "RSA",
        "encryption_key_size": "4096",
        "algorithm_certified": "sha256",
        "password_key": "api-password-key",
        "password_revocation": "api-password-revocation",
        "environments": "",
        "systems": "",
        "project": "",
        "ip_external": "",
        "ip_hostname": "",
        "justification": "API test",
        "self_signed": "true",
        "ca": "",
        "responsible": "31 - api-user",
        "description": "API test"
    }
  // Additional requests will be listed here
}

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.