API Koala : premiers appels, erreurs courantes et bonnes pratiques
Ce guide vous accompagne dans vos premiers appels a l'API Koala : authentification, structure des requetes, gestion des erreurs et bonnes pratiques pour integrer Koala dans vos workflows automatises.
Obtenir votre cle API
Connectez-vous a votre compte Koala AI et allez dans Settings > API. Copiez votre cle API. Cette cle est personnelle et ne doit pas etre partagee. Stockez-la dans une variable d'environnement, jamais en dur dans votre code.
Premier appel : generer 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 tache. La generation est asynchrone : vous pouvez verifier le statut via un endpoint de statut ou recevoir une notification webhook.
Gestion des erreurs
- 401 : cle API invalide ou expiree
- 429 : limite de debit atteinte (attendez puis reessayez)
- 402 : credits insuffisants (verifiez votre plan)
- 500 : erreur serveur (reessayez apres quelques secondes)
Bonnes pratiques
- Implementez un retry avec backoff exponentiel pour les erreurs 429 et 500
- Utilisez les webhooks plutot que le polling pour verifier le statut
- Stockez les articles generes avant de les publier (relecture humaine)
- Surveillez votre consommation de credits pour eviter les depassements
Pour une vue d'ensemble de l'API, consultez notre page API Koala. Pour les prix et quotas, consultez notre page prix.