Guide de démarrage rapide

Prérequis

Avant de commencer, vous avez besoin d'un compte Kataio. Si vous n'en avez pas encore, créez un compte gratuit — aucune carte de crédit requise.

Étape 1 : Obtenir votre clé API

Après vous être connecté à votre tableau de bord Kataio :

1. Naviguez vers Paramètres → Intégrations
2. Cliquez sur Créer une clé API
3. Donnez un nom descriptif à votre clé (ex : "Mon Intégration")
4. Copiez la clé immédiatement — elle ne sera affichée qu'une seule fois

Étape 2 : Effectuer votre première requête

Utilisez votre clé API pour récupérer votre catalogue produit :

curl -X GET "https://app.kataio.com/api/v1/products" \
  -H "X-API-Key: votre_cle_api" \
  -H "Accept: application/json"

Étape 3 : Analyser la réponse

L'API renvoie une réponse JSON avec un tableau data et des métadonnées de pagination :

{
  "data": [
    {
      "id": "prod_abc123",
      "name": "Casque sans fil Premium",
      "sku": "WH-PRO-001",
      "price": 149.99,
      "currency": "EUR",
      "status": "active",
      "categories": ["electronique", "audio"],
      "createdAt": "2026-03-01T10:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 42,
    "totalPages": 3
  }
}

Champs de réponse importants

• data — Tableau d'objets produit
• meta.page — Numéro de page actuel
• meta.perPage — Éléments par page (défaut : 20, max : 100)
• meta.total — Nombre total d'éléments correspondants
• meta.totalPages — Nombre total de pages

Étape 4 : Pagination

Utilisez les paramètres de requête pour paginer les résultats :

GET /api/v1/products?page=2&perPage=50

Prochaines étapes

• Authentification — Découvrez les clés API, les tokens JWT et les scopes
• Webhooks — Recevez des notifications en temps réel lorsque les données changent
• Limites de débit — Comprenez les limites de requêtes de votre plan
• Référence API — Explorez tous les endpoints disponibles