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

Legg til "callback_url" i POST /api/v1/jobs, så sender Do4U en signert POST (hendelsen job.finished med status, kreditter og resultatlenken - ikke selve resultatet) så snart jobben er ferdig. Kun offentlige adresser på port 80 eller 443; vi prøver på nytt opptil 6 ganger med økende pauser.

Eksempel: opprett en jobb med callback_url – og forespørselen Do4U sender til den adressen når jobben er ferdig:

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

Kontroller headeren X-Do4U-Signature: t=<time>,v1=<hex>, der v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Avvis gamle tidspunkter (f.eks. eldre enn 5 minutter). Hemmeligheten din begynner med whsec_ og vises på siden API-nøkler.

// 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 kreditsaldoen til en konto faller under terskelen, sender Do4U én signert POST til webhook-adressen til kontoen. Hendelsen inneholder ingen personopplysninger, bare saldoen, terskelen og tidspunktet (UTC). Den neste kommer først etter at det er lagt til kreditter igjen (kjøp, månedlige gratiskreditter eller kupongkode). Signatur og hemmelighet er de samme som for 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 angir adressen og terskelen her: API-nøkler

n8n

Ferdig arbeidsflyt: en webhook mottar kallet fra Do4U, kontrollerer signaturen, henter resultatet og gir det videre til neste steg.

Last ned n8n-malen (JSON)

Mal, ennå ikke testet i en ekte n8n- eller Make-instans – test signaturkontrollen før du bruker den.

I n8n: Workflows → Import from file. Skriv deretter inn hemmeligheten din i noden "Check signature" og API-nøkkelen din i "Do4U: get result", aktiver arbeidsflyten og bruk produksjons-URL-en til webhooken som callback_url. Selvhostet n8n trenger miljøvariabelen NODE_FUNCTION_ALLOW_BUILTIN=crypto for signaturkontrollen.

Make

1. Legg til modulen Webhooks → Custom webhook som utløser og slå på "JSON pass-through" og "Get request headers" i de avanserte innstillingene.
2. Bruk adressen til denne webhooken som callback_url.
3. Kontroller signaturen: sammenlign v1 fra headeren X-Do4U-Signature med sha256(t + "." + raw body; hex; hemmeligheten din).
4. Legg til HTTP → Make a request: GET på result_url med headeren Authorization: Bearer <your API key>.
5. Bruk feltet result i de neste modulene dine.

Mal, ennå ikke testet i en ekte n8n- eller Make-instans – test signaturkontrollen før du bruker den.

Oppskrifter: lenk verktøy sammen

En oppskrift kjører 2 til 4 verktøy etter hverandre som én jobb. Send «recipe» i stedet for «tool»: enten navnet på en ferdig oppskrift eller en liste med steg. Teksten går inn i det første steget. Resultatet fra hvert steg er teksten til neste steg. GET /api/v1/recipes viser de ferdige oppskriftene, verktøyene du kan bruke og feltet hvert verktøy gir 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 ett estimat for alle stegene (credits_estimate). Dette beløpet reserveres ved start. Etter hvert steg bokføres det faktiske forbruket, og resten forblir reservert til slutten, før det frigjøres. Et steg som mislykkes, koster ingenting, de resterende stegene hoppes over, og steg som allerede var ferdige, belastes.

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 steg med status (pending, queued, running, done, failed, skipped), kreditter, en melding input_shortened hvis teksten måtte forkortes for neste verktøy, og resultatet av hvert steg når oppskriften er avsluttet. Med no_store vises resultatene én gang. callback_url utløses én gang, på slutten av oppskriften.

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.

Svar på e-poster uten å endre innboksen din

Do4U driver ingen innboks og lagrer aldri tilgangsdata til postkassen din. To måter å få svarutkast på likevel:

S1 – Mal for n8n eller Make

1. Utløser: en ny e-post i postkassen din (IMAP-utløser i n8n eller Make – tilgangsdataene blir der)
2. POST /api/v1/jobs med verktøyet support_reply, e-postteksten og no_store: true
3. Vent noen sekunder og hent GET /api/v1/jobs/{id} til statusen er done
4. Opprett et utkast i postkassen din med teksten fra result.reply (Gmail- eller Outlook-modul)

Last ned n8n-malen (JSON)

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

Utvikler-utvidelser og butikkutvidelser

Pakk ut ZIP-filen og les den medfølgende veiledningen. Last nettleserutvidelsen lokalt; test butikkutvidelser i en testbutikk først. Du trenger din egen Dev API-nøkkel. Shopware tilbyr foreløpig en CLI.

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