Authentification

Chaque request vers l'API FourA nécessite une authentification. Cette page explique comment obtenir, utiliser et gérer votre clé API.

Obtenir votre clé API

1. Connectez-vous au Dashboard FourA
2. Accédez à la page API Keys
3. Cliquez sur Create Key
4. Copiez immédiatement la clé (elle ne sera plus affichée en entier)

Votre clé API ressemble à ceci : pk_live_a1b2c3d4e5f6...

Utiliser votre clé API

Incluez votre clé API dans le header X-API-Key de chaque 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' })
});

Sécurité de la clé API

Traisez votre clé API comme un mot de passe :

• Ne la validez pas dans votre système de contrôle de version. Utilisez plutôt des variables d'environnement.
• Ne l'exposez pas dans le code côté client. Utilisez-la uniquement dans des applications côté serveur.
• Renouvelez-la en cas de compromission. Créez une nouvelle clé depuis le Dashboard et désactivez l'ancienne.

Utiliser les variables d'environnement

Stockez votre clé dans une variable d'environnement :

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

Référencez-la ensuite dans votre code :

import os
api_key = os.environ["FOURA_API_KEY"]

const apiKey = process.env.FOURA_API_KEY;

Erreurs d'authentification courantes

Tous les échecs d'authentification renvoient un statut 401 Unauthorized.

Étapes suivantes

• Quick Start : Effectuez votre première request
• API Endpoints : Référence complète des endpoints
• Error Handling : Gerez les erreurs d'authentification de manière fluide