API documentation

With the Do4U API you use the same tools as on the website from your own software: summarise, compare, support replies, alt texts, rewrite and translate. Every request is processed on our own servers in Poland, EU.

Base URL: https://do4u.eu/api/v1

OpenAPI 3.1 description (JSON) – Machine-readable description of this API for code generators and tools such as Postman or Insomnia. No key needed.

Authentication

Create a key under API keys in your account. Send it with every request in the header Authorization: Bearer <key> (or X-API-Key: <key>). Keep the key secret and never put it into a web page. You can revoke a key at any time.

How it works

Jobs run asynchronously. You create a job and get its id at once (HTTP 202). Then you fetch the job until its status is done or failed. Ask every 2 to 5 seconds; most jobs take a few seconds.

Endpoints

Example

Create a job, then fetch the result:

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

Request fields for POST /jobs

Repeat requests safely (Idempotency-Key)

Send the header Idempotency-Key with POST /jobs, for example a random UUID for each job (1 to 255 printable ASCII characters). If the connection breaks and you send the same request again with the same Idempotency-Key and the same API key within 24 hours, you get the same answer again: the same job, no second job and no second charge. The answer then has the header Idempotent-Replayed: true. Use a new key for every new job. If you send the same key with a different request, you get 422 idempotency_conflict. Errors are not stored: after an error you can send the request again with the same key.

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": "..."}'

Tools and options

Job status

queued and running: still working (position and wait_seconds help you to wait). done: result contains the fields of the tool. failed: nothing was charged (credits is 0); error.code names the reason: address_blocked (Do4U does not open this address, for example a private or internal one; send the text or HTML instead), input_too_large (shorten the input), image_unavailable or job_failed. expired: the result is no longer stored.

Webhooks

Tilføj "callback_url" til POST /api/v1/jobs, så sender Do4U en signeret POST (hændelsen job.finished med status, credits og resultatlinket - ikke selve resultatet), så snart jobbet er færdigt. Kun offentlige adresser på port 80 eller 443; vi prøver igen op til 6 gange med stigende pauser.

Eksempel: opret et job med callback_url – og den forespørgsel, Do4U sender til den adresse, når jobbet er færdigt:

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..."}

Tjek headeren X-Do4U-Signature: t=<time>,v1=<hex>, hvor v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Afvis gamle tidspunkter (f.eks. ældre end 5 minutter). Din hemmelighed starter med whsec_ og vises på siden API-nøgler.

// 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

Når en kontos credit-saldo falder under tærsklen, sender Do4U én signeret POST til kontoens webhook-adresse. Hændelsen indeholder ingen personoplysninger, kun saldoen, tærsklen og tidspunktet (UTC). Den næste følger først, efter at der er tilføjet credits igen (køb, månedlige gratis credits eller gavekode). Signatur og hemmelighed er de samme som til 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"}

Du angiver adressen og tærsklen her: API-nøgler

n8n

Færdig workflow: en webhook modtager kaldet fra Do4U, kontrollerer signaturen, henter resultatet og giver det videre til dit næste trin.

Download n8n-skabelonen (JSON)

Skabelon, endnu ikke testet i en rigtig n8n- eller Make-instans – test signaturkontrollen, før du bruger den.

I n8n: Workflows → Import from file. Indtast derefter din hemmelighed i noden "Check signature" og din API-nøgle i "Do4U: get result", aktivér workflowet, og brug webhookens produktions-URL som callback_url. Selvhostet n8n kræver miljøvariablen NODE_FUNCTION_ALLOW_BUILTIN=crypto til signaturkontrollen.

Make

1. Tilføj modulet Webhooks → Custom webhook som udløser, og slå "JSON pass-through" og "Get request headers" til i dets avancerede indstillinger.
2. Brug denne webhooks adresse som callback_url.
3. Kontrollér signaturen: sammenlign v1 fra headeren X-Do4U-Signature med sha256(t + "." + raw body; hex; din hemmelighed).
4. Tilføj HTTP → Make a request: GET på result_url med headeren Authorization: Bearer <your API key>.
5. Brug feltet result i dine næste moduler.

Skabelon, endnu ikke testet i en rigtig n8n- eller Make-instans – test signaturkontrollen, før du bruger den.

Opskrifter: kæd værktøjer sammen

En opskrift kører 2 til 4 værktøjer efter hinanden som ét job. Send "recipe" i stedet for "tool": enten navnet på en færdig opskrift eller en liste over trin. Teksten går ind i det første trin; resultatet af hvert trin er teksten til det næste trin. GET /api/v1/recipes viser de færdige opskrifter, de værktøjer, du kan bruge, og det felt, hvert værktøj giver videre.

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 får ét overslag for alle trin (credits_estimate). Det beløb reserveres ved starten. Efter hvert trin bogføres det reelle forbrug, og resten forbliver reserveret til sidst og frigives så. Et mislykket trin koster ingenting, de resterende trin springes over, og trin, der allerede var færdige, afregnes.

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} viser hvert trin med dets status (pending, queued, running, done, failed, skipped), dets credits, en meddelelse input_shortened, hvis teksten skulle forkortes til det næste værktøj, og hvert trins resultat, når opskriften er afsluttet. Med no_store vises resultaterne én gang. callback_url udløses én gang, ved opskriftens afslutning.

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

Errors

Errors always have the same form: {"error": {"code": "...", "message": "..."}}. With 429 and 503 the header Retry-After says how many seconds to wait.

Limits

• 60 requests per minute per key and 120 per account.
• Open jobs at the same time per account: Free 3, Starter 3, Standard 5, Pro 10, for the website and the API together.
• Input: Free 8 000 characters, paid packages 30 000. Lower limits per tool: compare 20 000, alt_text 1 000, translate 12 000 (compare: both texts together).
• API keys: Free 1, Starter 1, Standard 5, Pro 10.

Credits

A new job shows an estimate (credits_estimate); charged is the actual use (credits). Failed jobs cost nothing. Free credits are used first.

Data

Inputs and results are stored for 7 days (Free) or 30 days (paid packages), then deleted. Images are deleted right after processing. Results are AI-generated: please check them before you use them.

Besvar e-mails uden at ændre din indbakke

Do4U driver ikke en indbakke og gemmer aldrig adgangsdata til din postkasse. To måder at få svarudkast alligevel:

S1 – Skabelon til n8n eller Make

1. Udløser: en ny e-mail i din postkasse (IMAP-udløser i n8n eller Make – adgangsdata bliver dér)
2. POST /api/v1/jobs med værktøjet support_reply, e-mailens tekst og no_store: true
3. Vent nogle sekunder, og hent GET /api/v1/jobs/{id}, indtil status er done
4. Opret et udkast i din postkasse med teksten fra result.reply (Gmail- eller Outlook-modul)

Download n8n-skabelonen (JSON)

I Make bygger du det samme scenarie af modulerne Email (watch emails), HTTP (make a request), Sleep og Gmail eller Outlook (create a draft).

Dev-udvidelser og shop-plugins

Pak ZIP-filen ud, og læs den medfølgende vejledning. Indlæs browserudvidelsen lokalt; test shop-plugins i en testshop først. Du skal bruge din egen Dev API-nøgle. Shopware tilbyder i øjeblikket en CLI.

• Do4U til WordPress (ZIP)
• Chrome / Firefox · Dev (ZIP)
• WooCommerce · Dev (ZIP)
• Shopware · CLI · Dev (ZIP)