Autenticación

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

Cómo obtener su API key

1. Inicie sesión en el Dashboard de FourA
2. Vaya a la página API Keys
3. Haga clic en Create Key
4. Copie la key inmediatamente (no se volverá a mostrar completa)

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

Cómo usar su API key

Incluya su 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

Trate su API key como una contraseña:

• No la suba al control de versiones. En su lugar, use variables de entorno.
• No la exponga en código del lado del cliente. Úsela únicamente en aplicaciones del lado del servidor.
• Rótela si se ve comprometida. Cree una nueva key desde el Dashboard y desactive la anterior.

Uso de variables de entorno

Almacene su key en una variable de entorno:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

Luego, haga referencia a ella en su 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.

Próximos pasos

• Quick Start: Realice su primer request
• API Endpoints: Referencia completa de endpoints
• Error Handling: Gestione los errores de autenticación de forma adecuada