Concepts

L'API Ziosting vous permet d'automatiser l'ensemble du cycle de vie de vos services managés. Toutes les opérations disponibles dans l'espace client sont également accessibles via API.

Automatisation

L'API est conçue pour s'intégrer dans vos workflows d'automatisation :

• Infrastructure as Code (Terraform, Pulumi)
• CI/CD pipelines
• Scripts de déploiement
• Monitoring et alerting personnalisés
• Outils de gestion d'infrastructure

Bonnes pratiques

Idempotence

Concevez vos scripts de manière idempotente pour gérer les erreurs réseau et les rejeux :

• Vérifiez l'état avant de créer une ressource
• Utilisez des identifiants uniques et prévisibles
• Gérez les erreurs de manière appropriée

Rate limiting

Respectez les limites de taux pour assurer la stabilité du service :

• Implémentez des retry avec backoff exponentiel
• Batchez vos requêtes quand possible (GraphQL)
• Cachez les données peu changeantes

Sécurité

Protégez vos credentials et vos données :

• Ne stockez jamais les tokens en clair dans votre code
• Utilisez des variables d'environnement ou un gestionnaire de secrets
• Rotez régulièrement vos tokens API
• Limitez les permissions au strict nécessaire

Monitoring

Surveillez l'utilisation de l'API :

• Loggez les appels API critiques
• Mettez en place des alertes sur les erreurs
• Suivez la latence de vos requêtes
• Documentez vos intégrations

Référence de l'API GraphQL

Retrouvez l'ensemble de la documentation de notre API GraphQL, exemple : query sur les backups