ÖFFENTLICHE API

Per Skript veröffentlichen mit der API

Eine kleine REST-API, um Websites anzulegen, ein Deployment hochzuladen und nachzulesen, was passiert ist, mit einer OpenAPI-Beschreibung, aus der Sie einen Client generieren können.

Kostenloser Tarif, SSL inklusive, ohne Kreditkarte.

Verfügbarkeit nach Tarif

Welche Tarife enthalten Öffentliche API?

API-Tokens gibt es ab dem Tarif Pro. Unsere eigenen Erweiterungen melden sich separat an und funktionieren in jedem Tarif.

  • Free Nicht enthalten
  • Starter Nicht enthalten
  • Pro Enthalten
  • Business Enthalten
  • Enterprise Enthalten

Diese Angaben stammen direkt aus den Tarifdaten, nach denen wir abrechnen. Sie entsprechen also immer dem, was Sie tatsächlich bekommen. Alle Tarife und Limits ansehen.

Das Prinzip

Dieselbe Veröffentlichung, ohne Browser

Ein Token, ein POST mit Ihrem Build, und die Website ist online. Es ist derselbe Weg wie im Dashboard, nur mit einer anderen Eingangstür.

Sie erstellen im Dashboard ein Token und rufen dann die API auf, um Ihre Websites aufzulisten, eine anzulegen und ein Deployment hochzuladen. Die Antwort nennt die Live-Adresse und den Status des Deployments. Ein Skript kann also darauf warten, statt zu raten. Die gesamte Schnittstelle ist in der API-Referenz beschrieben und in einem maschinenlesbaren OpenAPI-3.1-Dokument. Das reicht den meisten Generatoren, um einen Client zu erzeugen, ohne dass Sie selbst einen schreiben.

Der naheliegende Einsatz ist ein Release-Schritt: Ihr Build läuft weiter dort, wo er schon läuft, und die letzte Zeile veröffentlicht das Ergebnis hier. Das unterscheidet sich bewusst von einer Git-Integration. Wir beobachten kein Repository und führen Ihren Build nicht aus. Nichts hier braucht also Zugriff auf Ihren Quellcode: Sie bauen, wo Sie ohnehin bauen, und übergeben uns den Ordner. Rate-Limits gelten pro Tarif und pro Token. Eine Endlosschleife in einem Skript stößt also an eine Grenze, nicht an Ihre Rechnung.

Anleitung

Drei Schritte

  1. Token erstellen

    Tokens finden Sie im Dashboard unter API tokens. Jedes hat einen Namen und lässt sich einzeln widerrufen.

  2. API aufrufen

    Legen Sie bei Bedarf eine Website an und laden Sie dann Ihren gebauten Ordner als Deployment hoch. Die Referenz enthält die genauen Aufrufe.

  3. Ergebnis auslesen

    Die Antwort enthält die Live-Adresse und den Status des Deployments. Ihr Skript kann also mit einer klaren Fehlermeldung abbrechen, statt anzunehmen, dass alles geklappt hat.

Wo es sich lohnt

Wann man es nutzt

Ein Release-Schritt am Ende Ihres Builds

Der letzte Befehl Ihrer Pipeline veröffentlicht das Ergebnis. Was jede Toolchain wohin schreibt, steht in den Build-Anleitungen für Frameworks.

Generierte Berichte nach Zeitplan veröffentlichen

Ein nächtlicher Job, der HTML rendert und hochlädt, damit unter derselben Adresse immer die Zahlen von gestern stehen.

Ein eigenes Tool, das Nutzern einen Link gibt

Ein interner Generator, der einen Ort für sein Ergebnis braucht. Veröffentlichen Sie über die API und geben Sie der Person eine URL statt eines Downloads.

Die Alternative

So geht es ohne Droply

Der Vergleich, auf den es ankommt, ist keine andere API, sondern die Git-basierten Plattformen, die das hier bewusst nicht ist.

  Droply Eine mit Git verbundene Plattform
Was eine Veröffentlichung auslöst Ihr Aufruf, wann immer Sie wollen. Ein Push auf einen beobachteten Branch.
Zugriff auf Ihren Quellcode Keiner. Wir sehen das Repository nie. Der Repository-Zugriff ist die Integration.
Wo der Build läuft Wo er schon heute läuft. Auf deren Build-Servern, in deren Umgebung.
Ganz ohne Repository veröffentlichen Der Normalfall. Im Modell gibt es kein Repository. Braucht meist stattdessen einen Weg über die CLI.
Was Sie schicken Den fertigen Ordner. Den Quellcode plus eine Build-Konfiguration.

Verglichen mit dem Git-Integrationsmodell der Entwicklerplattformen, nicht mit einem bestimmten Anbieter. Stand: September 2026.

Wann Sie etwas anderes brauchen

Das veröffentlicht statische Ergebnisse. Ein Build-Dienst ist es nicht, eine allgemeine Datei-API auch nicht.

  • Es gibt keine Git-Integration, keinen Webhook bei einem Push und keinen Build-Schritt. Sie bauen, dann laden Sie hoch.
  • Es liefert aus, was Sie hochladen. Serverseitiger Code läuft nicht. Eine API, die Ihre Anwendung ausführen soll, gehört also nicht dazu.
  • API-Tokens sind eine kostenpflichtige Funktion. Wollen Sie nur aus einem Editor oder einem Browser veröffentlichen, erledigt das die VS-Code-Erweiterung in jedem Tarif.
  • Für API-Aufrufe gelten Rate-Limits und Tarifgrenzen genau wie im Dashboard.

Häufige Fragen

Welcher Tarif enthält den API-Zugang?
API-Tokens gibt es ab dem Tarif Pro. Davon getrennt sind unsere eigenen Erweiterungen: Sie melden sich mit einem per E-Mail geschickten Code an und funktionieren in jedem Tarif, auch im kostenlosen.
Gibt es eine OpenAPI-Beschreibung?
Ja, OpenAPI 3.1, als JSON ausgeliefert. Die meisten Client-Generatoren übernehmen sie unverändert, und die Referenz verlinkt darauf.
Kann ich aus einer CI heraus deployen?
Ja, das ist der Haupteinsatz. Ihr Build läuft, wo er schon läuft, und ein Aufruf am Ende lädt den Ausgabeordner hoch.
Verbindet sie sich mit meinem Git-Repository?
Nein, und das ist auch nicht geplant. Wir fragen nie nach Zugriff auf ein Repository. Das heißt auch: Nichts hier kann Ihren Quellcode lesen.
Kann ich ein Token widerrufen?
Ja. Tokens stehen mit Namen im Dashboard und lassen sich einzeln widerrufen. Ein Token aus einem CI-Job können Sie also ersetzen, ohne die anderen anzufassen.
Gibt es Rate-Limits?
Ja, pro Tarif und pro Token. Ein lautes Skript kann also nicht das Kontingent eines anderen aufbrauchen.

Weiterlesen