API PUBLIQUE

Publier depuis un script avec l’API

Une petite API REST pour créer des sites, envoyer un déploiement et suivre ce qui s’est passé, avec une description OpenAPI à partir de laquelle générer un client.

Offre gratuite, SSL offert, sans carte bancaire.

Disponibilité selon l’offre

Quelles offres incluent API publique ?

Les jetons d’API sont disponibles à partir de l’offre Pro. Les extensions officielles se connectent autrement et fonctionnent dans toutes les offres.

  • Free Non inclus
  • Starter Non inclus
  • Pro Inclus
  • Business Inclus
  • Enterprise Inclus

Cette liste provient directement des offres que nous facturons : elle correspond donc toujours à ce que vous obtenez. Voir toutes les offres et leurs limites.

Le principe

La même publication, sans le navigateur

Un jeton, un POST avec votre build, et le site est en ligne. C’est le circuit de publication du tableau de bord, avec une autre porte d’entrée.

Vous créez un jeton dans le tableau de bord, puis vous appelez l’API pour lister vos sites, en créer un et y envoyer un déploiement. La réponse vous donne l’adresse en ligne et l’état du déploiement : un script peut donc attendre au lieu de deviner. Toute l’API est décrite dans la référence de l’API et dans un document OpenAPI 3.1 lisible par une machine, ce qui suffit à la plupart des générateurs pour produire un client sans que vous ayez à l’écrire.

L’usage évident, c’est une étape de mise en production : votre build tourne là où il tourne déjà, et la dernière ligne publie le résultat ici. C’est volontairement différent d’une intégration Git. Nous ne surveillons aucun dépôt et nous n’exécutons pas votre build : rien ici n’a besoin d’accéder à vos sources. Vous compilez là où vous compilez déjà et vous nous remettez le dossier. Les limites de requêtes sont fixées par offre et par jeton : une boucle qui s’emballe dans un script se heurte à un plafond, pas à votre facture.

Mode d’emploi

Trois étapes

  1. Créez un jeton

    Les jetons se trouvent dans le tableau de bord, rubrique API tokens, et chacun porte un nom et peut être révoqué individuellement.

  2. Appelez l’API

    Créez un site si besoin, puis envoyez votre dossier compilé comme déploiement. La référence donne les appels exacts.

  3. Lisez le résultat

    La réponse contient l’adresse en ligne et l’état du déploiement : votre script peut échouer clairement au lieu de supposer que tout a marché.

Là où elle fait la différence

Quand s’en servir

Une étape de mise en production à la fin du build

La dernière commande de votre pipeline publie le résultat. Consultez les guides de build par framework pour savoir ce que chaque outil produit, et où.

Publier des rapports générés à heure fixe

Une tâche de nuit qui génère du HTML et l’envoie, pour que la même adresse affiche toujours les chiffres de la veille.

Un outil maison qui remet un lien à ses utilisateurs

Un générateur interne qui a besoin d’un endroit où déposer ce qu’il produit. Publiez via l’API et donnez une URL à la personne au lieu d’un fichier à télécharger.

L’alternative

Faire la même chose sans Droply

La comparaison qui compte n’est pas avec une autre API, mais avec les plateformes basées sur Git que celle-ci, volontairement, n’est pas.

  Droply Une plateforme connectée à Git
Ce qui déclenche une publication Votre appel, quand vous le décidez. Un push sur une branche surveillée.
Accès à vos sources Aucun. Nous ne voyons jamais le dépôt. L’accès au dépôt est le principe même de l’intégration.
Où tourne le build Là où il tourne déjà. Sur leurs machines, dans leur environnement.
Publier sans aucun dépôt Normal. Le modèle ne prévoit aucun dépôt. Passe en général par une CLI à la place.
Ce que vous envoyez Le dossier final. Les sources, plus une configuration de build.

Comparaison avec le modèle d’intégration Git des plateformes pour développeurs, et non avec un éditeur précis. Vérifié en septembre 2026.

Quand ce n’est pas le bon outil

Cette API publie un résultat statique. Ce n’est ni un service de build ni une API de fichiers généraliste.

  • Pas d’intégration Git, pas de webhook au push, pas d’étape de build. Vous compilez, puis vous envoyez.
  • Elle sert ce que vous envoyez. Elle ne peut pas exécuter de code côté serveur : une API qui doit faire tourner votre application est hors périmètre.
  • Les jetons d’API sont une fonctionnalité payante. Si vous voulez simplement publier depuis un éditeur ou un navigateur, l’extension VS Code le fait dans toutes les offres.
  • Les limites de requêtes et les limites de l’offre s’appliquent aux appels d’API exactement comme dans le tableau de bord.

Questions fréquentes

Quelle offre inclut l’accès à l’API ?
Les jetons d’API sont disponibles à partir de l’offre Pro. C’est distinct des extensions officielles, qui se connectent avec un code reçu par e-mail et fonctionnent dans toutes les offres, y compris l’offre gratuite.
Existe-t-il une description OpenAPI ?
Oui, en OpenAPI 3.1, servie en JSON. La plupart des générateurs de clients l’acceptent telle quelle, et la référence y renvoie.
Puis-je déployer depuis ma CI ?
Oui, c’est l’usage principal. Votre build tourne là où il tourne déjà, et un seul appel à la fin envoie le dossier de sortie.
Se connecte-t-elle à mon dépôt Git ?
Non, et ce n’est pas prévu. Nous ne demandons jamais d’accès à un dépôt, ce qui signifie aussi que rien ici ne peut lire vos sources.
Puis-je révoquer un jeton ?
Oui. Les jetons sont listés dans le tableau de bord, nommés et révocables un par un : un jeton placé dans une tâche de CI peut être remplacé sans toucher aux autres.
Y a-t-il des limites de requêtes ?
Oui, selon l’offre et calculées par jeton : un script trop bavard ne peut pas épuiser le quota d’un autre.

Pour aller plus loin