Authentifizierung¶

API-Key erstellen¶

API-Keys werden im VNET in der Browserversion unter Einstellungen erstellt. Beim Erstellen legst du fest, welche Scopes der Schlüssel erhalten soll.

Bearer-Token¶

Sende den API-Key bei jedem Request im Authorization-Header:

JavaScriptPythoncURL

const response = await fetch(
    "https://api.statev.de/req/factory/list/",
    {
        headers: {
            Authorization: "Bearer <API-Key>",
        },
    }
);

const data = await response.json();

import requests

response = requests.get(
    "https://api.statev.de/req/factory/list/",
    headers={"Authorization": "Bearer <API-Key>"},
    timeout=10,
)
data = response.json()

curl "https://api.statev.de/req/factory/list/" \
  -H "Authorization: Bearer <API-Key>"

Typische Fehler¶

Status	Bedeutung
`400 Bad Request`	Scope, Parameter oder fachliche Voraussetzung fehlt
`401 Unauthorized`	API-Key fehlt, ist ungültig oder der Zugriff ist nicht erlaubt
`404 Not Found`	Angeforderte Firma oder Ressource wurde nicht gefunden
`429 Too Many Requests`	Das Request-Limit wurde überschritten

URL-Aufbau

Die in der Referenz gezeigten Pfade werden immer an https://api.statev.de/req angehängt.