DEOpen the app

For developers

Everything the app can do. Via API.

Start flows from your ERP, shop or script, track progress, fetch results and get notified via webhook.

trigger.sh
# Secret URL from the flow editor (trigger “Webhook”), no 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" }

# Or as a schedule, e.g. every night at 3 am
{ "trigger": { "type": "schedule", "cron": "0 3 * * *", "timezone": "Europe/Berlin" } }
  • 01

    OpenAPI 3.1

    Machine-readable description at /api/openapi.json – generate clients for any language.

  • 02

    Cost up front

    With dryRun you estimate credits per step and check your balance without starting anything.

  • 03

    Preview via API

    Test a flow on a sample before it processes every product.

  • 04

    Signed webhooks

    HMAC-SHA256 with timestamp, https only, delivery log of the last 50 events.

  • 05

    Flow triggers

    A secret URL without a token for systems that can only call an address. Or a cron schedule.

  • 06

    Company tokens

    Tokens belong to the company, not a person, and are stored only as a hash.

Events

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

You’ll find the full API documentation in the app under Developers.

flow.sh
export HC=https://app.heavy-cloud.de
export TOKEN=hc_...   # App → Developers → API tokens

# 1. Estimate the cost (starts nothing)
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. Start – without 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. Progress and results
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"

Your catalogue can do more.

Coming soon

Open the app

Currently in closed beta. Public access is on its way.