Authentifizierung

Jeder Request an die FourA API erfordert eine Authentifizierung. Diese Seite erklärt, wie du deinen API-Key abrufst, verwendest und verwaltest.

API-Key abrufen

1. Melde dich im FourA Dashboard an
2. Gehe zur Seite API Keys
3. Klicke auf Create Key
4. Kopiere den Key sofort (er wird nicht noch einmal vollständig angezeigt)

Dein API-Key sieht so aus: pk_live_a1b2c3d4e5f6...

API-Key verwenden

Füge deinen API-Key in den X-API-Key-Header jedes Requests ein:

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"}'

In 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"}
)

In 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' })
});

API-Key-Sicherheit

Behandle deinen API-Key wie ein Passwort:

• Committe ihn nicht in die Versionsverwaltung. Nutze stattdessen Umgebungsvariablen.
• Gib ihn nicht im clientseitigen Code preis. Nutze ihn nur in serverseitigen Anwendungen.
• Rotiere ihn bei Kompromittierung. Erstelle einen neuen Key im Dashboard und deaktiviere den alten.

Umgebungsvariablen nutzen

Speichere deinen Key in einer Umgebungsvariablen:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

Referenziere ihn dann in deinem Code:

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

const apiKey = process.env.FOURA_API_KEY;

Häufige Authentifizierungsfehler

Alle Authentifizierungsfehler geben den Status 401 Unauthorized zurück.

Nächste Schritte

• Quick Start: Sende deinen ersten Request
• API Endpoints: Vollständige Endpoint-Referenz
• Error Handling: Authentifizierungsfehler sauber behandeln