REST- en GraphQL-documentatie. Bouw op jouw manier.

Elk verzoek heeft een API-sleutel nodig. Maak een account, genereer een testsleutel en roep de endpoints hieronder aan; testsleutels geven voorbeelddata, live sleutels actuele marktdata voor de markten in je abonnement.

Authenticatie

De API gebruikt een bearer-token. Houd live sleutels op je server en zet ze nooit in een publieke appbundel; gebruik in browsers een testsleutel of een sleutel met origin-beperking.

Authorization: Bearer YOUR_API_KEY

Resources

GraphQL: kies je velden

Vraag een product en zijn marktspecifieke prijzen op via één endpoint. Selecteer alleen de velden die je interface nodig heeft, met hetzelfde onderliggende datamodel als REST.

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

Stuur een JSON-body met query en variabelen. In het voorbeeld hieronder past de marktkeuze de variabelen en de voorbeeldrespons aan. De tabs Query, Variabelen en Respons horen bij hetzelfde verzoek.

Het schema dekt productopzoeking, marktprijzen en prijshistorie. Querycomplexiteit is per verzoek begrensd en elk GraphQL-verzoek telt één keer mee in je quota; een geneste query is geen onbeperkte data voor één verzoek.

Codevoorbeelden

VoorbeeldresponsKA—001

KICKSAPI ORIGINAL

Concept 01

KA-001 / EU 42

Markt

Prijs€189.00

Statisch voorbeeld · de live API geeft actuele marktdata

API-vorm

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

Actualiteit en ontbrekende waarden

Bewaar zowel het waarnemingstijdstip van de bron als de ontvangsttijd. Een null-prijs betekent dat geen bruikbare prijs beschikbaar is. Maak er geen nul van en behandel een vraagprijs niet als afgeronde verkoop.

Foutafhandeling

Houd rekening met 401 voor ongeldige gegevens, 404 voor onbekende producten, 429 voor limieten en 503 voor tijdelijke uitval. Bewaar de laatste geldige momentopname en toon de ouderdom als een update mislukt.

Controleer bij GraphQL zowel de HTTP-status als de errors-array. Een antwoord kan gedeeltelijke data en fouten bevatten. De integratievoorbeelden wijzen antwoorden met fouten af; productie-apps kunnen bepalen hoe bruikbare deelresultaten worden getoond.