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

Lägg till "callback_url" i POST /api/v1/jobs, så skickar Do4U en signerad POST (händelsen job.finished med status, krediter och resultatlänken - inte själva resultatet) så fort jobbet är klart. Bara offentliga adresser på port 80 eller 443; vi försöker igen upp till 6 gånger med växande pauser.

Exempel: skapa ett jobb med callback_url – och anropet som Do4U skickar till den adressen när jobbet är klart:

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

Kontrollera rubriken X-Do4U-Signature: t=<time>,v1=<hex>, där v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Avvisa gamla tidsvärden (t.ex. äldre än 5 minuter). Din hemlighet börjar med whsec_ och visas på sidan API-nycklar.

// 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 ett kontos kreditsaldo sjunker under tröskelvärdet skickar Do4U en signerad POST till kontots webhook-adress. Händelsen innehåller inga personuppgifter, bara saldot, tröskelvärdet och tiden (UTC). Nästa kommer först efter att krediter har lagts till igen (köp, månatliga gratiskrediter eller kupong). Signatur och hemlighet är desamma som för 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 anger adressen och tröskelvärdet här: API-nycklar

n8n

Färdigt arbetsflöde: en webhook tar emot anropet från Do4U, kontrollerar signaturen, hämtar resultatet och lämnar över det till ditt nästa steg.

Ladda ned n8n-mallen (JSON)

Mall, ännu inte testad i en riktig n8n- eller Make-instans – testa signaturkontrollen innan du använder den.

I n8n: Workflows → Import from file. Ange sedan din hemlighet i noden "Check signature" och din API-nyckel i "Do4U: get result", aktivera arbetsflödet och använd webhookens produktions-URL som callback_url. Självhostad n8n behöver miljövariabeln NODE_FUNCTION_ALLOW_BUILTIN=crypto för signaturkontrollen.

Make

1. Lägg till modulen Webhooks → Custom webhook som utlösare och slå på "JSON pass-through" och "Get request headers" i dess avancerade inställningar.
2. Använd den här webhookens adress som callback_url.
3. Kontrollera signaturen: jämför v1 från rubriken X-Do4U-Signature med sha256(t + "." + raw body; hex; din hemlighet).
4. Lägg till HTTP → Make a request: GET på result_url med rubriken Authorization: Bearer <your API key>.
5. Använd fältet result i dina nästa moduler.

Mall, ännu inte testad i en riktig n8n- eller Make-instans – testa signaturkontrollen innan du använder den.

Recept: kedja verktyg

Ett recept kör 2 till 4 verktyg efter varandra som ett enda jobb. Skicka "recipe" i stället för "tool": antingen namnet på ett färdigt recept eller en lista med steg. Texten går in i det första steget. Resultatet av varje steg är texten för nästa steg. GET /api/v1/recipes listar de färdiga recepten, de verktyg du kan använda och det fält som varje verktyg för vidare.

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 en uppskattning för alla steg (credits_estimate). Det beloppet reserveras vid starten. Efter varje steg bokförs den verkliga användningen och resten förblir reserverad till slutet och frigörs sedan. Ett misslyckat steg kostar ingenting, de återstående stegen hoppas över, och steg som redan var klara debiteras.

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} visar varje steg med sin status (pending, queued, running, done, failed, skipped), sina krediter, ett meddelande input_shortened om texten behövde kortas för nästa verktyg, samt resultatet av varje steg när receptet har avslutats. Med no_store visas resultaten en enda gång. callback_url anropas en gång, vid receptets slut.

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.

Svara på mejl utan att byta inkorg

Do4U driver ingen inkorg och sparar aldrig åtkomstuppgifter till din brevlåda. Två sätt att ändå få svarsutkast:

S1 – Mall för n8n eller Make

1. Utlösare: ett nytt mejl i din brevlåda (IMAP-utlösare i n8n eller Make – åtkomstuppgifterna stannar där)
2. POST /api/v1/jobs med verktyget support_reply, mejltexten och no_store: true
3. Vänta några sekunder och hämta GET /api/v1/jobs/{id} tills statusen är done
4. Skapa ett utkast i din brevlåda med texten från result.reply (Gmail- eller Outlook-modul)

Ladda ned n8n-mallen (JSON)

I Make bygger du samma scenario av modulerna Email (watch emails), HTTP (make a request), Sleep och Gmail eller Outlook (create a draft).

Dev-tillägg och butiksplugin

Packa upp ZIP-filen och läs den medföljande guiden. Läs in webbläsartillägget lokalt; testa butiksplugin först i en testbutik. Din egen Dev-API-nyckel krävs. Shopware har för närvarande ett CLI.

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