Authentifizierung

Alle API-Anfragen erfordern Authentifizierung per Bearer Token im Authorization-Header.

Einen API-Key erhalten

  1. 1

    Konto erstellen

    Registrieren Sie sich auf unserer Entwicklerseite. Sie erhalten eine kostenlose 14-tägige Testphase mit vollem API-Zugang.

  2. 2

    Ihren API-Key generieren

    Navigieren Sie in Ihrem Dashboard zu Einstellungen → API Keys, um einen neuen Key zu erstellen.

  3. 3

    Speichern Sie Ihren Key sicher

    Ihr API-Key wird nur einmal angezeigt. Speichern Sie ihn an einem sicheren Ort, z.B. als Umgebungsvariable.

Ihren API-Key verwenden

Fügen Sie Ihren API-Key als Bearer Token im Authorization-Header jeder Anfrage ein:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://grapeminds.eu/api/public/v1/wines

Beispiel mit verschiedenen Sprachen

Verwenden Sie den Accept-Language-Header, um Beschreibungen in Ihrer bevorzugten Sprache zu erhalten:

# German
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: de" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

# French
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: fr" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

Authentifizierungsfehler

401 Unauthenticated

Der API-Key fehlt oder ist ungültig. Stellen Sie sicher, dass Sie einen gültigen Bearer Token einfügen.

{ "message": "Unauthenticated." }
403 Forbidden

Ihr API-Key hat keine Berechtigung für diese Ressource. Enterprise-Endpunkte erfordern ein Enterprise-Abonnement.

Sicherheits-Best-Practices

Geben Sie Ihren API-Key niemals in clientseitigem Code oder öffentlichen Repositories preis.

Verwenden Sie Umgebungsvariablen, um Ihren API-Key zu speichern.

Rotieren Sie Ihren API-Key regelmäßig. Dies können Sie in Ihrem Dashboard unter Einstellungen → API Keys tun.

Verwenden Sie immer HTTPS für API-Anfragen.

Bereit loszulegen?

Testen Sie die grapeminds Wine API 14 Tage kostenlos.

Als API Kunde registrieren