Authentification API
S’authentifier auprès de l’API Spark!
Dernière mise à jour : 2026-01-19
L’API Spark! utilise des clés API pour l’authentification. Incluez votre clé dans l’en-tête Authorization de chaque requête.
Obtenir votre clé API
- Accédez à Settings → API → API Keys
- Cliquez sur "Create API Key"
- Nommez la clé, par exemple « Production » ou « Préproduction »
- Définissez les autorisations : lecture seule ou lecture-écriture
- Copiez la clé et conservez-la en sécurité
Garder les clés secrètes
Les clés API donnent un accès complet aux données Spark!. Ne les exposez jamais dans le code côté client, des dépôts publics ou des journaux.
Utiliser votre clé API
Incluez la clé dans l’en-tête Authorization :
Authorization: Bearer YOUR_API_KEY
Limites de débit
Le débit des requêtes API est limité :
- Standard — 100 requêtes par minute
- Opérations en masse — 10 requêtes par minute
- Webhooks — Illimités en sortie
Chaque réponse contient les en-têtes de limite :
X-RateLimit-Limit— Maximum de requêtes autoriséesX-RateLimit-Remaining— Requêtes restantesX-RateLimit-Reset— Horodatage Unix de réinitialisation
Gestion des erreurs
Les erreurs renvoient les codes HTTP standards :
- 400 — Requête incorrecte, paramètres invalides
- 401 — Non authentifié, clé API invalide ou manquante
- 403 — Interdit, autorisations insuffisantes
- 404 — Introuvable
- 429 — Trop de requêtes, débit limité
- 500 — Erreur serveur
Environnements
- Production —
https://api.chargezen.com/spark/v1 - Bac à sable —
https://sandbox.chargezen.com/spark/v1
Tests en bac à sable
Utilisez le bac à sable pour les tests. Il reproduit la production sans affecter les données réelles ni déclencher de paiements réels.
Prochaines étapes
Cette page vous a-t-elle été utile ?
Besoin d’aide ? Contacter l’assistance