API-Dokumentation

Mit der Do4U-API nutzt du dieselben Werkzeuge wie auf der Website aus deiner eigenen Software: zusammenfassen, vergleichen, Support-Antworten, Alt-Texte, umschreiben und übersetzen. Jede Anfrage verarbeiten wir auf eigenen Servern in Polen, EU.

Basis-URL: https://do4u.eu/api/v1

OpenAPI-3.1-Beschreibung (JSON) – Maschinenlesbare Beschreibung dieser API für Code-Generatoren und Werkzeuge wie Postman oder Insomnia. Ohne Schlüssel abrufbar.

Anmeldung

Leg unter „API-Schlüssel" in deinem Konto einen Schlüssel an. Schick ihn bei jeder Anfrage im Kopf Authorization: Bearer <Schlüssel> (oder X-API-Key: <Schlüssel>). Halte den Schlüssel geheim und bau ihn nie in eine Webseite ein. Du kannst ihn jederzeit widerrufen.

So funktioniert es

Aufträge laufen im Hintergrund. Du legst einen Auftrag an und bekommst sofort seine ID (HTTP 202). Dann fragst du den Auftrag ab, bis der Status done oder failed ist. Frag alle 2 bis 5 Sekunden; die meisten Aufträge dauern ein paar Sekunden.

Endpunkte

Beispiel

Auftrag anlegen, dann das Ergebnis abholen:

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool": "summarize", "text": "...", "options": {"length": "short"}, "language": "en"}'

HTTP/1.1 202 Accepted
{"id": "8f1c0b6a...", "tool": "summarize", "status": "queued", "model": "do4u-standard",
 "credits_estimate": 1, "links": {"self": "https://do4u.eu/api/v1/jobs/8f1c0b6a..."}}

curl https://do4u.eu/api/v1/jobs/8f1c0b6a... -H "Authorization: Bearer d4u_YOUR_KEY"

{"id": "8f1c0b6a...", "tool": "summarize", "status": "done", "model": "do4u-standard", "credits_estimate": 1,
 "result": {"summary": "...", "key_points": ["...", "..."]}, "credits": 1,
 "notice": "AI-generated, please check before use."}

curl -X POST https://do4u.eu/api/v1/jobs -H "Authorization: Bearer d4u_YOUR_KEY" \
  -F tool=alt_text -F language=de -F "text=Product page: hiking boots" -F image=@photo.jpg

Felder für POST /jobs

Anfragen sicher wiederholen (Idempotency-Key)

Schick bei POST /jobs den Kopf Idempotency-Key mit, zum Beispiel eine zufällige UUID je Auftrag (1 bis 255 druckbare ASCII-Zeichen). Bricht die Verbindung ab und du schickst dieselbe Anfrage mit demselben Idempotency-Key und demselben API-Schlüssel innerhalb von 24 Stunden noch einmal, bekommst du dieselbe Antwort: derselbe Auftrag, kein zweiter Auftrag und keine zweite Abbuchung. Die Antwort trägt dann den Kopf Idempotent-Replayed: true. Nimm für jeden neuen Auftrag einen neuen Schlüssel. Schickst du denselben Schlüssel mit einer anderen Anfrage, kommt 422 idempotency_conflict. Fehler werden nicht gespeichert: Nach einem Fehler kannst du die Anfrage mit demselben Schlüssel noch einmal schicken.

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Idempotency-Key: 5f0c2a8e-7d1b-4c3a-9e2f-1b6d8a4c0e77" \
  -H "Content-Type: application/json" \
  -d '{"tool": "summarize", "text": "..."}'

Werkzeuge und Optionen

Status eines Auftrags

queued und running: läuft noch (position und wait_seconds helfen beim Warten). done: result enthält die Felder des Werkzeugs. failed: Es wurde nichts berechnet (credits ist 0); error.code nennt den Grund: address_blocked (Do4U öffnet diese Adresse nicht, zum Beispiel eine private oder interne; schick stattdessen Text oder HTML), input_too_large (Eingabe kürzen), image_unavailable oder job_failed. expired: Das Ergebnis ist nicht mehr gespeichert.

Webhooks

Gib bei POST /api/v1/jobs "callback_url" mit, dann schickt Do4U einen signierten POST (Ereignis job.finished mit Status, Credits und dem Link auf das Ergebnis - nicht das Ergebnis selbst), sobald der Auftrag fertig ist. Nur öffentliche Adressen auf Port 80 oder 443; wir versuchen es bis zu 6-mal mit wachsenden Pausen.

Beispiel: Auftrag mit callback_url anlegen – und die Anfrage, die Do4U an diese Adresse schickt, sobald der Auftrag fertig ist:

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool": "summarize", "text": "...", "callback_url": "https://example.com/do4u-hook"}'

POST /do4u-hook
Content-Type: application/json
X-Do4U-Event: job.finished
X-Do4U-Signature: t=1793180000,v1=6b1f...

{"event":"job.finished","id":"8f1c0b6a...","tool":"summarize","status":"done","credits":1,
 "created":"2026-10-28T10:00:00+01:00","finished":"2026-10-28T10:00:04+01:00","result_url":"https://do4u.eu/api/v1/jobs/8f1c0b6a..."}

Prüfe die Kopfzeile X-Do4U-Signature: t=<zeit>,v1=<hex>, mit v1 = HMAC-SHA256(Geheimnis, "<zeit>.<roher Rumpf>"). Weise alte Zeiten ab (z. B. älter als 5 Minuten). Dein Geheimnis beginnt mit whsec_ und steht auf der Seite API-Schlüssel.

// Node.js: rawBody = the request body exactly as received (string)
const crypto = require('crypto');
function do4uSignatureOk(rawBody, header, secret) {
  const t = (header.match(/t=(\d+)/) || [])[1];
  const v1 = (header.match(/v1=([0-9a-f]{64})/) || [])[1];
  if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = crypto.createHmac('sha256', secret).update(t + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

// PHP
function do4u_signature_ok(string $raw, string $header, string $secret): bool {
    if (!preg_match('/t=(\d+),v1=([0-9a-f]{64})/', $header, $m) || abs(time() - (int)$m[1]) > 300) return false;
    return hash_equals(hash_hmac('sha256', $m[1] . '.' . $raw, $secret), $m[2]);
}
$ok = do4u_signature_ok(file_get_contents('php://input'), $_SERVER['HTTP_X_DO4U_SIGNATURE'] ?? '', 'whsec_YOUR_SECRET');

credits.low

Fällt das Guthaben eines Kontos unter die Schwelle, schickt Do4U einmal einen signierten POST an die Webhook-Adresse des Kontos. Das Ereignis enthält keine personenbezogenen Daten, nur Guthaben, Schwelle und Zeitpunkt (UTC). Das nächste kommt erst, wenn wieder Credits dazugekommen sind (Kauf, Free-Credits des Monats oder Gutschein). Signatur und Geheimnis sind dieselben wie bei job.finished.

POST /do4u-hook
Content-Type: application/json
X-Do4U-Event: credits.low
X-Do4U-Signature: t=1793180000,v1=6b1f...

{"event":"credits.low","balance":18,"threshold":20,"ts":"2026-10-29T10:00:04Z"}

Adresse und Schwelle stellst du hier ein: API-Schlüssel

n8n

Fertiger Workflow: Ein Webhook nimmt den Aufruf von Do4U an, prüft die Signatur, holt das Ergebnis ab und gibt es an deinen nächsten Schritt weiter.

Vorlage für n8n herunterladen (JSON)

Vorlage, noch nicht in einer echten n8n- bzw. Make-Instanz getestet – bitte teste die Signaturprüfung vor dem Einsatz.

In n8n: Workflows → Import from file. Dann im Knoten „Check signature" dein Geheimnis und in „Do4U: get result" deinen API-Schlüssel eintragen, den Workflow aktivieren und die Production-URL des Webhooks als callback_url nutzen. Selbst betriebenes n8n braucht für die Signaturprüfung die Umgebungsvariable NODE_FUNCTION_ALLOW_BUILTIN=crypto.

Make

1. Nimm das Modul Webhooks → Custom webhook als Auslöser und schalte in seinen erweiterten Einstellungen „JSON pass-through" und „Get request headers" ein.
2. Nutze die Adresse dieses Webhooks als callback_url.
3. Prüfe die Signatur: Vergleiche v1 aus der Kopfzeile X-Do4U-Signature mit sha256(t + "." + roher Rumpf; hex; dein Geheimnis).
4. Füge HTTP → Make a request hinzu: GET auf result_url mit der Kopfzeile Authorization: Bearer <dein API-Schlüssel>.
5. Nutze das Feld result in deinen nächsten Modulen.

Vorlage, noch nicht in einer echten n8n- bzw. Make-Instanz getestet – bitte teste die Signaturprüfung vor dem Einsatz.

Rezepte: Werkzeuge verketten

Ein Rezept führt 2 bis 4 Werkzeuge nacheinander als einen Auftrag aus. Sende „recipe“ statt „tool“: entweder den Namen eines fertigen Rezepts oder eine Liste von Schritten. Der Text geht in den ersten Schritt; das Ergebnis jedes Schritts ist der Text für den nächsten. GET /api/v1/recipes listet die fertigen Rezepte, die nutzbaren Werkzeuge und das Feld, das jedes Werkzeug weitergibt.

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipe": [{"tool": "summarize", "options": {"length": "short"}},
               {"tool": "translate", "options": {"target": "pl"}}], "text": "..."}'

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipe": "summary_translate_meta", "options": {"target": "pl"}, "text": "..."}'

Du bekommst eine Schätzung für alle Schritte (credits_estimate). Dieser Betrag wird zu Beginn reserviert. Nach jedem Schritt wird der echte Verbrauch gebucht, der Rest bleibt bis zum Ende reserviert und wird dann freigegeben. Ein fehlgeschlagener Schritt kostet nichts, die übrigen Schritte entfallen, und schon fertige Schritte werden berechnet.

HTTP/1.1 202 Accepted
{"id": "3c9e0d1a...", "tool": "recipe", "recipe": null, "status": "queued", "model": "do4u-standard", "credits_estimate": 4,
 "steps": [{"n": 1, "tool": "summarize", "credits_estimate": 2}, {"n": 2, "tool": "translate", "credits_estimate": 2}],
 "links": {"self": "https://do4u.eu/api/v1/jobs/3c9e0d1a..."}}

GET /api/v1/jobs/{id} zeigt jeden Schritt mit Status (pending, queued, running, done, failed, skipped), seinen Credits, dem Hinweis input_shortened, wenn der Text für das nächste Werkzeug gekürzt werden musste, und dem Ergebnis jedes Schritts, sobald das Rezept zu Ende ist. Mit no_store werden die Ergebnisse einmal gezeigt. callback_url wird genau einmal ausgelöst, am Ende des Rezepts.

GET https://do4u.eu/api/v1/jobs/3c9e0d1a...

{"id": "3c9e0d1a...", "tool": "recipe", "status": "done", "credits_estimate": 4, "credits": 3, "steps_total": 2,
 "steps": [{"n": 1, "tool": "summarize", "status": "done", "credits": 1, "result": {"summary": "...", "key_points": ["..."]}},
           {"n": 2, "tool": "translate", "status": "done", "credits": 2, "notices": ["input_shortened"], "result": {"translation": "...", "notes": []}}],
 "result": {"translation": "...", "notes": []}}

GET https://do4u.eu/api/v1/recipes

Fehler

Fehler haben immer dieselbe Form: {"error": {"code": "...", "message": "..."}}. Bei 429 und 503 sagt der Kopf Retry-After, wie viele Sekunden du warten sollst.

Grenzen

• 60 Anfragen pro Minute je Schlüssel und 120 je Konto.
• Gleichzeitig offene Aufträge je Konto: Free 3, Starter 3, Standard 5, Pro 10, Website und API zusammen.
• Eingabe: Free 8.000 Zeichen, bezahlte Pakete 30.000. Niedrigere Grenzen je Werkzeug: compare 20.000, alt_text 1.000, translate 12.000 (compare: beide Texte zusammen).
• API-Schlüssel: Free 1, Starter 1, Standard 5, Pro 10.

Credits

Ein neuer Auftrag zeigt eine Schätzung (credits_estimate); berechnet wird der tatsächliche Verbrauch (credits). Fehlgeschlagene Aufträge kosten nichts. Gratis-Credits werden zuerst verbraucht.

Daten

Eingaben und Ergebnisse speichern wir 7 Tage (Free) bzw. 30 Tage (bezahlte Pakete), danach werden sie gelöscht. Bilder löschen wir direkt nach der Verarbeitung. Die Ergebnisse sind KI-generiert: Bitte prüf sie, bevor du sie verwendest.

E-Mails beantworten, ohne das Postfach zu wechseln

Do4U betreibt kein Postfach und speichert nie Zugangsdaten zu deinem Postfach. Zwei Wege, trotzdem Antwortentwürfe zu bekommen:

S1 – Vorlage für n8n oder Make

1. Auslöser: neue E-Mail in deinem Postfach (IMAP-Auslöser in n8n oder Make – die Zugangsdaten bleiben dort)
2. POST /api/v1/jobs mit tool support_reply, dem Text der E-Mail und no_store: true
3. Ein paar Sekunden warten und GET /api/v1/jobs/{id} abfragen, bis der Status done ist
4. Im Postfach einen Entwurf mit dem Text aus result.reply anlegen (Gmail- oder Outlook-Modul)

n8n-Vorlage herunterladen (JSON)

In Make baust du dasselbe Szenario aus den Modulen E-Mail (E-Mails beobachten), HTTP (Anfrage senden), Sleep und Gmail oder Outlook (Entwurf anlegen).

Dev-Erweiterungen und Shop-Plugins

ZIP entpacken und die beiliegende Anleitung lesen. Browser-Erweiterung lokal laden; Shop-Plugins zuerst im Testshop prüfen. Ein eigener Dev-API-Schlüssel ist erforderlich. Shopware bietet zunächst eine CLI.

• Do4U für WordPress (ZIP)
• Chrome / Firefox · Dev (ZIP)
• WooCommerce · Dev (ZIP)
• Shopware · CLI · Dev (ZIP)