GET | Listar uma requisição

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

Endpoint: /api/certificate/request/list/{id_requisicao}
Método: GET
Requisição: GET /api/certificate/request/list/{id_requisicao}

Parâmetros do caminho

Parâmetro	Tipo	Obrigatório	Descrição
`id_requisicao`	`int`	Sim	ID da solicitação que será listada.

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?code_request=1" \
  -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"
    }
}

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.