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 et la consultation de produits, les prix de marché et l’historique des prix. Un document compte pour une requête et peut résoudre au plus 50 jeux de prix et 5 historiques ; au-delà, les champs en trop renvoient une erreur query_too_large à côté des données qui tiennent. Un document qui ne s’analyse ou ne se valide pas n’est pas décompté.

Exemples de code

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

Fraîcheur et valeurs absentes

Conservez l’heure d’observation de la source et le moment où vous avez reçu la réponse. Un prix null signifie qu’aucun prix exploitable n’est disponible. Ne transformez pas les valeurs manquantes en zéro et ne prenez pas un prix demandé pour une vente conclue. Une taille peut être null dans un système que la marque n’utilise pas ; tous les systèmes du produit figurent sous sizes.

Gestion des erreurs

Prévoyez 401 pour identifiants invalides, 402 quand le solde ne couvre pas l’offre, 403 quand un marché ou une fonction n’est pas inclus dans votre offre, 404 pour produit inconnu, 429 pour limites et 503 pour indisponibilité temporaire. Chaque erreur comporte un code lisible par machine et un request_id, et les requêtes refusées ne sont pas décomptées. 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.