Autenticación

Cada request a la API de FourA requiere autenticación. Esta página explica cómo obtener, usar y gestionar tu API key.

Cómo obtener tu API key

  1. Inicia sesión en el FourA Dashboard
  2. Ve a la página API Keys
  3. Haz clic en Create Key
  4. Copia la key del diálogo de confirmación

Tu API key se ve así: pk_live_a1b2c3d4e5f6...

Las keys creadas hoy son revelables: haz clic en el icono del ojo en la fila de la key más tarde para ver el secret completo bajo demanda (consulta Managing API Keys para el flujo de revelado y permisos). Las keys heredadas creadas antes del lanzamiento de esta función no se pueden volver a mostrar y tienen un icono de candado; regeneralas una vez para cambiarlas.

Cómo usar tu API key

Incluye tu API key en el header X-API-Key de cada request:

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'

En Python:

import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)

En Node.js:

const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});

Seguridad de la API key

Trata tu API key como una contraseña:

  • No la confirmes en el control de versiones. Usa variables de entorno en su lugar.
  • No la expongas en código del lado del cliente. Úsala únicamente en aplicaciones del lado del servidor.
  • Rótala si se ve comprometida. Regenera la key desde el Dashboard. El secreto anterior dejará de funcionar en un minuto, y cada visualización queda registrada en el log de auditoría para que sea fácil detectar una credencial robada a posteriori.

Uso de variables de entorno

Guarda tu key en una variable de entorno:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

Luego haz referencia a él en tu código:

import os
api_key = os.environ["FOURA_API_KEY"]
const apiKey = process.env.FOURA_API_KEY;

Errores comunes de autenticación

Todos los fallos de autenticación devuelven un estado 401 Unauthorized.

Error Mensaje Causa Solución
401 Missing API key. Include X-API-Key header. Falta el header X-API-Key en la request Añade el header X-API-Key
401 Invalid API key Key incorrecta, espacios en blanco adicionales o key desactivada Verifica la key, elimina los espacios en blanco o genera una nueva key desde el Dashboard

Si FourA no puede verificar una key temporalmente, por ejemplo durante una conmutación por error en su base de datos, responde 503 con API key check temporarily unavailable y Retry-After: 5, nunca 401. Reintenta la solicitud tras esa espera: tu key no tiene problemas.

Cada response, sea un éxito o un fallo, incluye un header X-Foura-Request-Id, salvo en el caso de un body que FourA no pueda leer en absoluto (JSON mal formado o un body que supere los 100 KB), el cual se rechaza antes de asignar un ID. Regístralo en tus logs para que el equipo de soporte pueda consultar una llamada específica más adelante.

Siguientes pasos

Actualizado: 29 de octubre de 2026