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 und -abruf, Marktpreise und Preisverlauf. Ein Dokument zählt als eine Anfrage und darf höchstens 50 Preissätze und 5 Verläufe auflösen; darüber liefern die zusätzlichen Felder einen query_too_large-Fehler neben den Daten, die passen. Ein Dokument, das sich nicht parsen oder validieren lässt, wird nicht gezählt.

Codebeispiele

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

Aktualität und fehlende Werte

Speichere sowohl die Beobachtungszeit der Quelle als auch den Zeitpunkt, zu dem du die Antwort erhalten hast. Ein Preis null bedeutet, dass kein verwertbarer Preis vorliegt. Mach aus fehlenden Werten keine Null und werte einen Angebotspreis nicht als abgeschlossenen Verkauf. Eine Größe kann in einem System null sein, das die Marke nicht verwendet; jedes System des Produkts steht unter sizes.

Fehlerbehandlung

Berücksichtige 401 für ungültige Zugangsdaten, 402, wenn das Guthaben den Tarif nicht deckt, 403, wenn ein Markt oder eine Funktion nicht in deinem Tarif ist, 404 für unbekannte Produkte, 429 für Limits und 503 für temporäre Ausfälle. Jeder Fehler enthält einen maschinenlesbaren Fehlercode und eine request_id, und abgelehnte Anfragen werden nicht gezählt. 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.