REST- und GraphQL-Dokumentation. Entwickle auf deine Art.

Jede Anfrage braucht einen API-Schlüssel. Erstelle ein Konto, hole dir einen Testschlüssel und rufe die Endpunkte unten auf; Testschlüssel liefern Beispieldaten, Live-Schlüssel aktuelle Marktdaten für die Märkte deines Tarifs.

Authentifizierung

Die API verwendet ein Bearer-Token. Halte Live-Schlüssel auf deinem Server und lege sie nie in ein öffentliches App-Bundle; nutze im Browser einen Testschlüssel oder einen Origin-beschränkten Schlüssel.

Authorization: Bearer YOUR_API_KEY

Ressourcen

GraphQL: wähle deine Felder

Frage ein Produkt und seine marktspezifischen Preise über einen Endpunkt ab. Wähle nur die Felder, die deine Oberfläche braucht, auf demselben Datenmodell wie REST.

POST /graphql
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Sende einen JSON-Body mit query und variables. Im Beispiel unten passt die Marktauswahl die Variablen und die Beispielantwort an. Die Tabs Query, Variablen und Antwort gehören zu derselben Anfrage.

Das Schema umfasst Produktsuche, Marktpreise und Preisverlauf. Die Query-Komplexität ist pro Anfrage begrenzt und jede GraphQL-Anfrage zählt einmal auf dein Kontingent; eine verschachtelte Query bedeutet keine unbegrenzten Daten für eine Anfrage.

Codebeispiele

BeispielantwortKA—001

KICKSAPI ORIGINAL

Concept 01

KA-001 / EU 42

Markt

Preis€189.00

Statisches Beispiel · die Live-API liefert aktuelle Marktdaten

API-Variante

RESTGraphQL

JSONJavaScriptPython

GET /v1/products/ka_concept_001/prices

{
  "id": "ka_concept_001",
  "name": "KicksAPI Concept 01",
  "style_code": "KA-001",
  "market": "NL",
  "currency": "EUR",
  "variants": [
    {
      "size": "42",
      "size_system": "EU",
      "asking_price": 189
    }
  ],
  "source": "stockx",
  "observed_at": "2026-09-10T08:00:00Z"
}

Live-APIREST / JSON

Aktualität und fehlende Werte

Speichere Beobachtungs- und Empfangszeit. Ein null-Preis bedeutet, dass kein nutzbarer Preis verfügbar ist. Ersetze fehlende Werte nicht durch null Euro und interpretiere Angebotspreise nicht als Verkäufe.

Fehlerbehandlung

Berücksichtige 401 für ungültige Zugangsdaten, 404 für unbekannte Produkte, 429 für Limits und 503 für temporäre Ausfälle. Bewahre die letzte gültige Aufnahme auf und zeige ihr Alter, wenn ein Update fehlschlägt.

Prüfe bei GraphQL sowohl den HTTP-Status als auch das errors-Array. Antworten können Teildaten und Fehler enthalten. Die Integrationsbeispiele weisen Antworten mit Fehlern zurück; Produktionsanwendungen können selbst entscheiden, wie sie nutzbare Teilergebnisse anzeigen.