Konvertierungs-API

Authentifizierung

Erstelle unter Einstellungen → API-Schlüssel einen Schlüssel und sende ihn bei jeder Anfrage mit:

x-api-key: <dein Schlüssel>

Konvertierungen werden vom Credit-Guthaben des Schlüsselinhabers abgebucht (10 Credits pro Auftrag, alle Formate inbegriffen). Fehlgeschlagene Aufträge werden automatisch erstattet.

Konvertierung starten

Sende die unveränderten Bilddaten als PNG, JPEG oder WebP:

curl -X POST https://layerback.com/api/v1/convert \
  -H "x-api-key: $LAYERBACK_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @diagram.png

{ "job_id": "5c048e6f-ec4d-43ad-9eee-0697414d5cef" }

Die API antwortet mit 402 bei leerem Guthaben, 413 bei mehr als 20 MB, 415 bei nicht unterstützten Daten und 429 beim Erreichen des Stundenlimits.

Auftragsstatus abfragen

curl https://layerback.com/api/v1/jobs/$JOB_ID \
  -H "x-api-key: $LAYERBACK_KEY"

{
  "job_id": "5c048e6f-…",
  "status": "succeeded",
  "total_seconds": 46.9,
  "formats": ["vsdx", "pptx", "drawio", "svg", "ir", "preview"]
}

status wechselt von queued zu running und anschließend zu succeeded oder failed. Eine Abfrage alle paar Sekunden genügt; die meisten Aufträge benötigen 30–60 Sekunden.

Dateien herunterladen

curl -L "https://layerback.com/api/v1/jobs/$JOB_ID/download?format=vsdx" \
  -H "x-api-key: $LAYERBACK_KEY" -o diagram.vsdx

Für format sind vsdx, pptx, drawio, svg, ir (strukturiertes Diagramm-JSON) und preview (PNG) zulässig. Downloads sind kostenlos wiederholbar. Da der Endpunkt mit 302 auf eine kurzlebige Download-URL weiterleiten kann, muss der Client Weiterleitungen verfolgen (-L bei curl).

Webhook bei Abschluss

Statt den Status abzufragen, übergib beim Start eine öffentliche HTTPS-Adresse als callback_url:

curl -X POST "https://layerback.com/api/v1/convert?callback_url=https://deine.app/hooks/layerback" \
  -H "x-api-key: $LAYERBACK_KEY" \
  --data-binary @diagram.png

Der Webhook erhält Erfolg und Fehler im selben Schema. Die Zustellung wird zweimal versucht; wichtige Ergebnisse sollten zusätzlich über den Auftragsendpunkt geprüft werden.

OpenAPI und Limits

Die vollständige Spezifikation steht unter layerback.com/openapi.yaml.

• PNG, JPEG und WebP bis 20 MB
• 20 Konvertierungen pro Stunde und Konto; für Stapelverarbeitung bitte davie@daviechen.com kontaktieren
• Dateien bleiben mindestens 72 Stunden verfügbar und sollten rechtzeitig heruntergeladen werden