Documentation REST et GraphQL. Développez à votre façon.

Chaque requête nécessite une clé API. Créez un compte, générez une clé de test et appelez les endpoints ci-dessous ; les clés de test renvoient des données d’exemple, les clés de production les données de marché actuelles des marchés de votre offre.

Authentification

L’API utilise un jeton bearer. Gardez les clés de production sur votre serveur et ne les exposez jamais dans un bundle d’app public ; dans un navigateur, utilisez une clé de test ou une clé restreinte par origine.

Authorization: Bearer YOUR_API_KEY

Ressources

GraphQL : choisissez vos champs

Interrogez un produit et ses prix par marché via un seul endpoint. Sélectionnez uniquement les champs dont votre interface a besoin, sur le même modèle de données que REST.

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

Envoyez un corps JSON contenant query et variables. Dans l’exemple ci-dessous, le sélecteur de marché met à jour les variables et la réponse d’exemple. Les onglets Requête, Variables et Réponse appartiennent à la même requête.

Le schéma couvre la recherche de produits, les prix de marché et l’historique des prix. La complexité des requêtes est plafonnée par requête et chaque requête GraphQL est décomptée une fois de votre quota ; une requête imbriquée n’équivaut pas à des données illimitées pour une requête.

Exemples de code

Réponse d’exempleKA—001

KICKSAPI ORIGINAL

Concept 01

KA-001 / EU 42

Marché

Prix€189.00

Exemple statique · l’API en production renvoie les données de marché actuelles

Type d’API

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"
}

API en productionREST / JSON

Fraîcheur et valeurs absentes

Conservez date d’observation et date de réception. Un prix null signifie qu’aucun prix exploitable n’est disponible. Ne le remplacez pas par zéro et ne confondez pas offre et vente réalisée.

Gestion des erreurs

Prévoyez 401 pour identifiants invalides, 404 pour produit inconnu, 429 pour limites et 503 pour indisponibilité temporaire. Conservez le dernier relevé valide et affichez son ancienneté si une mise à jour échoue.

Avec GraphQL, vérifiez le statut HTTP et le tableau errors. Une réponse peut contenir des données partielles et des erreurs. Les exemples d’intégration rejettent les réponses avec erreurs ; les apps en production peuvent choisir comment afficher les résultats partiels utilisables.