ENZur App

Für Entwickler

Alles, was das Portal kann. Per API.

Starte Flows aus deinem ERP, Shop oder Skript, verfolge den Fortschritt, hol Ergebnisse ab und lass dich per Webhook benachrichtigen.

trigger.sh
# Geheime URL aus dem Flow-Editor (Auslöser „Webhook“), ohne Token
curl -s -H 'Content-Type: application/json' \
  -d '{"rows":[{"sku":"TF-750","image_1":"https://shop.example/tf-750.jpg"}]}' \
  "https://app.heavy-cloud.de/hooks/flows/<key>"
# → 202 { "runId": "…", "status": "queued" }

# Oder als Zeitplan, z. B. jede Nacht um 3 Uhr
{ "trigger": { "type": "schedule", "cron": "0 3 * * *", "timezone": "Europe/Berlin" } }
  • 01

    OpenAPI 3.1

    Maschinenlesbare Beschreibung unter /api/openapi.json – Clients für jede Sprache erzeugen.

  • 02

    Kosten vorab

    Mit dryRun schätzt du Credits je Schritt und prüfst das Guthaben, ohne etwas zu starten.

  • 03

    Vorschau per API

    Teste einen Flow an einer Stichprobe, bevor er alle Artikel bearbeitet.

  • 04

    Signierte Webhooks

    HMAC-SHA256 mit Zeitstempel, nur https, Zustellprotokoll der letzten 50 Ereignisse.

  • 05

    Flow-Auslöser

    Geheime URL ohne Token für Systeme, die nur eine Adresse aufrufen können. Oder ein Cron-Zeitplan.

  • 06

    Firmen-Tokens

    Tokens gehören zur Firma, nicht zur Person, und werden nur als Hash gespeichert.

Ereignisse

  • run.started
  • run.awaiting_approval
  • run.finished
  • run.failed
  • run.cancelled
  • run.item.finished
  • credits.low

Die vollständige API-Dokumentation findest du in der App unter Entwickler.

flow.sh
export HC=https://app.heavy-cloud.de
export TOKEN=hc_...   # Portal → Entwickler → API-Tokens

# 1. Kosten schätzen (startet nichts)
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{ "dryRun": true, "rows": [
        { "sku": "TF-750", "image_1": "https://shop.example/tf-750.jpg",
          "name_de": "Edelstahl Trinkflasche 750ml" } ] }' \
  "$HC/api/flows/$FLOW/runs"

# 2. Starten – ohne dryRun
RUN=$(curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{ "name": "Import", "rows": [ { "sku": "TF-750", "image_1": "https://shop.example/tf-750.jpg" } ] }' \
  "$HC/api/flows/$FLOW/runs" | jq -r .id)

# 3. Fortschritt und Ergebnisse
curl -s -H "Authorization: Bearer $TOKEN" "$HC/api/runs/$RUN" | jq '.run | {status, counts, credits}'
curl -s -H "Authorization: Bearer $TOKEN" "$HC/api/runs/$RUN/items?page=1&pageSize=200"

Dein Katalog kann mehr.

Bald verfügbar

Zur App

Aktuell in der geschlossenen Beta. Der öffentliche Zugang folgt.