v1.0

Crear clave de API

POSThttps://api.pasarela.hi-g.io/v1/api-keys

Crea una clave adicional. Las claves anteriores siguen funcionando, así que se puede rotar sin cortar el servicio. El cuerpo es opcional.

Ver el ejemplo y probar ↓

La clave completa se muestra una sola vez

api_key solo viene en esta respuesta. El servidor guarda únicamente su huella, así que no se puede recuperar después: si la pierdes, crea otra.

Parámetros del cuerpo

labelstring

Nombre para distinguir la clave. Máximo 80 caracteres. Acepta null.

Cabeceras

x-api-keystringobligatorio

Clave de API de la empresa. Se crea y se revoca desde el panel.

Respuestas

Lenguaje

Credenciales

x-api-key

Cabecera

Petición cURL

1curl --request POST \2     --url 'https://api.pasarela.hi-g.io/v1/api-keys' \3     --header 'accept: application/json' \4     --header 'content-type: application/json' \5     --header 'x-api-key: sk_test_…' \6     --data '7{8  "label": "Rotación octubre"9}10'

Se ejecuta de verdad con tu clave.

Respuesta

Elige un ejemplo:

application/json

{
  "key": {
    "id": "f80946e4-e26e-4ca8-802d-db3f52bb60b5",
    "prefix": "sk_test_a81d",
    "label": "Rotación octubre",
    "created_at": "2026-10-13T16:10:02.771Z",
    "last_used_at": null,
    "revoked_at": null
  },
  "api_key": "sk_test_a81d…"
}

Revocar clave de API