API Koala : premiers appels, erreurs courantes et bonnes pratiques
Ce guide vous accompagne dans vos premiers appels à l'API Koala : authentification, structure des requêtes, gestion des erreurs et bonnes pratiques pour intégrer Koala dans vos workflows automatisés.
Obtenir votre clé API
Connectez-vous à votre compte Koala AI et allez dans Settings > API. Copiez votre clé API. Cette clé est personnelle et ne doit pas être partagée. Stockez-la dans une variable d'environnement, jamais en dur dans votre code.
Premier appel : générer un article
POST https://koala.sh/api/articles/
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
"targetKeyword": "meilleur outil SEO 2026",
"language": "French",
"articleType": "blog_post",
"enableRealTimeData": true,
"enableDeepResearch": true
}L'API retourne un identifiant de tâche. La génération est asynchrone : vous pouvez vérifier le statut via un endpoint de statut ou recevoir une notification webhook.
Gestion des erreurs
- 401 : clé API invalide ou expirée
- 429 : limite de débit atteinte (attendez puis réessayez)
- 402 : crédits insuffisants (vérifiez votre plan)
- 500 : erreur serveur (réessayez après quelques secondes)
Bonnes pratiques
- Implémentez un retry avec backoff exponentiel pour les erreurs 429 et 500
- Utilisez les webhooks plutôt que le polling pour vérifier le statut
- Stockez les articles générés avant de les publier (relecture humaine)
- Surveillez votre consommation de crédits pour éviter les dépassements
Pour une vue d'ensemble de l'API, consultez notre page API Koala. Pour les prix et quotas, consultez notre page prix.