Quickstart — votre premier appel API en 2 minutes

Ce guide vous montre comment générer une clé d'API, puis appeler un endpoint Servolution.

1. Créer une clé d'API depuis votre compte

Connectez-vous à votre SaaS (par ex. app.commertra.servolution.fr) puis allez dans Paramètres → API Keys.

Cliquez sur Nouvelle clé. Donnez-lui un libellé (par ex. script-import-csv) et choisissez un tier :

Free — 1 000 requêtes / jour
Pro — 10 000 requêtes / jour
Enterprise — illimité (sur devis)

La clé complète sk_srv_… ne vous sera affichée qu'une seule fois. Copiez-la dans votre gestionnaire de secrets immédiatement.

2. Faire votre premier appel

Toutes les routes publiques se trouvent sous /api/v1/public/. Exemple : /api/v1/public/ping.

curl https://app.commertra.servolution.fr/api/v1/public/ping \
  -H "X-API-Key: sk_srv_VOTRE_CLE"

# Réponse
{
  "ok": true,
  "company_id": 42,
  "tier": "free",
  "label": "script-import-csv"
}

3. Lire les headers de quota

Chaque réponse contient :

X-RateLimit-Limit:     1000
X-RateLimit-Remaining: 998
X-RateLimit-Reset:     43200    (secondes avant minuit UTC)

4. Gérer les erreurs

Code	Sens	Action
401	Header X-API-Key manquant ou clé invalide/révoquée	Vérifier la clé, régénérer si besoin
403	Scope insuffisant pour l'endpoint demandé	Mettre à jour les scopes dans Paramètres → API Keys
429	Quota journalier dépassé	Attendre le reset (header Reset) ou upgrader le tier
500	Erreur côté Servolution	Réessayer avec backoff exponentiel

5. Et après ?

Lisez la documentation d'authentification complète (scopes, rotation, expiration)
Explorez l'API Reference Redoc pour découvrir tous les endpoints
Suivez un tutoriel end-to-end (Stripe → Comptentra, Weboria → Commertra…)