Développeurs
L’API existe. La référence publique, pas encore.
Tout sur cette plateforme (la boutique, le panier, le panneau) communique déjà avec une seule API. Ce que nous n’avons pas fait, c’est la publier : il n’existe aujourd’hui ni jetons client ni documentation de référence, et nous préférons le dire plutôt que vous vendre une capture d’écran.
Aujourd’hui
Ce qui est réellement vrai à ce jour.
La boutique et le panneau fonctionnent déjà sur notre propre API interne. La publier suppose une documentation, l’émission de jetons et des engagements de stabilité que nous pouvons tenir, et rien de cela n’existe encore.
Ce qui n’existe pas encore : des clés API que vous pouvez créer vous-même, une référence publiée avec schémas, et les engagements de stabilité qui rendent une API digne qu’on bâtisse dessus. Tant que nous ne pouvons pas mettre par écrit des politiques de version et d’obsolescence, nous ne distribuons pas de jetons : une API qui change sous vos pieds est pire que pas d’API.
Si votre flux de travail exige dès aujourd’hui une mise en service par programme, dites-nous ce que vous construisez via le formulaire de demande. L’intérêt exprimé influence réellement l’ordre dans lequel nous développons, et l’accès anticipé commencera par les personnes qui l’ont demandé.
Périmètre prévu
Ce que couvrira l’API publique.
Voici les fonctionnalités dont dispose déjà l’API interne et que l’API publique exposera. Prévu signifie prévu : rien de tout cela n’est appelable par les clients aujourd’hui.
- Cycle de vie des serveurs
- Créez, réinstallez, redémarrez et supprimez des serveurs depuis votre propre code : les opérations que le panneau effectue aujourd’hui.
- Catalogue en direct
- Offres, régions et images système sous forme de données, aux mêmes prix que la boutique, y compris votre remise partenaire le cas échéant.
- Domaines et DNS
- Recherchez, enregistrez et gérez les enregistrements via la même intégration de bureau d’enregistrement que le site.
- Utilisation et facturation
- Un relevé heure par heure lisible par programme : les chiffres dont vous auriez besoin pour refacturer vos propres clients.
- Des webhooks, pas d’interrogation
- Les événements du cycle de vie envoyés à votre endpoint et signés, pour que vos systèmes réagissent au lieu d’interroger.
- Jetons à périmètre limité
- Clés en lecture seule, mise en service seule ou accès complet, révocables instantanément, avec journaux d’audit par jeton.
Les principes que nous suivons : du REST simple avec des codes d’état significatifs, des clés d’idempotence sur les appels qui modifient, cloud-init user_data à la création, des limites de débit indiquées dans les en-têtes de réponse, et des erreurs qui vous disent quoi faire ensuite. Volontairement sans surprise.
Manifester votre intérêt
Dites-nous ce que vous construiriez avec.
Une phrase sur votre cas d’usage suffit. Vous aurez de nos nouvelles quand il y aura quelque chose de concret à essayer, pas une campagne d’e-mails automatisés.