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

Cuir "callback_url" le POST /api/v1/jobs, agus seolann Do4U POST sínithe (imeacht job.finished le stádas, creidmheasanna agus nasc an toraidh - ní an toradh féin) a luaithe a bhíonn an jab déanta. Seoltaí poiblí ar chalafort 80 nó 443 amháin; déanaimid iarracht arís suas le 6 huaire le sosanna atá ag éirí níos faide.

Sampla: cruthaigh jab le callback_url – agus an t-iarratas a sheolann Do4U chuig an seoladh sin nuair a bhíonn an jab críochnaithe:

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

Seiceáil an ceanntásc X-Do4U-Signature: t=<time>,v1=<hex>, áit a bhfuil v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Diúltaigh d’amanna sean (m.sh. níos sine ná 5 nóiméad). Tosaíonn do rún le whsec_ agus taispeántar é ar an leathanach Eochracha API.

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

Nuair a thiteann iarmhéid creidmheasa cuntais faoin tairseach, seolann Do4U POST sínithe amháin chuig seoladh webhook an chuntais. Níl aon sonraí pearsanta san imeacht, ach an t-iarmhéid, an tairseach agus an t-am (UTC). Ní leanann an chéad cheann eile ach tar éis creidmheasanna a chur leis arís (ceannach, creidmheasanna míosúla saor in aisce nó dearbhán). Is ionann síniú agus rún agus iad siúd do 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"}

Socraíonn tú an seoladh agus an tairseach anseo: Eochracha API

n8n

Sreabhadh oibre réamhdhéanta: faigheann webhook an glao ó Do4U, seiceálann sé an síniú, faigheann sé an toradh agus tugann sé don chéad chéim eile é.

Íoslódáil an teimpléad n8n (JSON)

Teimpléad, nár tástáladh fós i bhfíor-chás n8n nó Make – tástáil an tseiceáil sínithe sula n-úsáideann tú é.

In n8n: Workflows → Import from file. Ansin cuir isteach do rún sa nód "Check signature" agus d’eochair API in "Do4U: get result", gníomhachtaigh an sreabhadh oibre agus úsáid URL táirgeachta an webhook mar callback_url. Teastaíonn an athróg timpeallachta NODE_FUNCTION_ALLOW_BUILTIN=crypto ó n8n féinóstáilte don tseiceáil sínithe.

Make

1. Cuir an modúl Webhooks → Custom webhook leis mar thruicear agus cas air "JSON pass-through" agus "Get request headers" ina ardsocruithe.
2. Úsáid seoladh an webhook seo mar callback_url.
3. Seiceáil an síniú: cuir v1 ón gceanntásc X-Do4U-Signature i gcomparáid le sha256(t + "." + raw body; hex; do rún).
4. Cuir HTTP → Make a request leis: GET ar result_url leis an gceanntásc Authorization: Bearer <your API key>.
5. Úsáid an réimse result i do chéad mhodúil eile.

Teimpléad, nár tástáladh fós i bhfíor-chás n8n nó Make – tástáil an tseiceáil sínithe sula n-úsáideann tú é.

Oidis: ceangail uirlisí le chéile

Ritheann oideas 2 go 4 uirlis ceann i ndiaidh a chéile mar jab amháin. Seol "recipe" in ionad "tool": ainm oidis réamhdhéanta nó liosta céimeanna. Téann an téacs isteach sa chéad chéim; is é toradh gach céime an téacs don chéad chéim eile. Liostaíonn GET /api/v1/recipes na hoidis réamhdhéanta, na huirlisí is féidir leat a úsáid agus an réimse a thugann gach uirlis ar aghaidh.

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

Faigheann tú meastachán amháin do gach céim (credits_estimate). Áirithítear an méid sin ag an tús. Tar éis gach céime cuirtear an úsáid iarbhír in áireamh agus fanann an chuid eile áirithe go dtí an deireadh, ansin scaoiltear í. Ní chosnaíonn céim theipthe aon rud, scipeáiltear na céimeanna eile, agus gearrtar as céimeanna a bhí críochnaithe cheana.

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

Taispeánann GET /api/v1/jobs/{id} gach céim lena stádas (pending, queued, running, done, failed, skipped), a creidmheasanna, fógra input_shortened má b’éigean an téacs a ghiorrú don chéad uirlis eile, agus toradh gach céime nuair a bhíonn an t-oideas críochnaithe. Le no_store taispeántar na torthaí uair amháin. Lasann callback_url uair amháin, ag deireadh an oidis.

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.

Freagair ríomhphoist gan do bhosca isteach a athrú

Ní ritheann Do4U bosca isteach agus ní stórálann sé sonraí rochtana do do bhosca poist riamh. Dhá bhealach chun dréacht-fhreagraí a fháil mar sin féin:

S1 – Teimpléad do n8n nó Make

1. Truicear: ríomhphost nua i do bhosca poist (truicear IMAP in n8n nó Make – fanann na sonraí rochtana ansin)
2. POST /api/v1/jobs leis an uirlis support_reply, téacs an ríomhphoist agus no_store: true
3. Fan cúpla soicind agus faigh GET /api/v1/jobs/{id} go dtí go mbíonn an stádas done
4. Cruthaigh dréacht i do bhosca poist leis an téacs ó result.reply (modúl Gmail nó Outlook)

Íoslódáil an teimpléad n8n (JSON)

In Make, tóg an cás céanna ó na modúil Email (watch emails), HTTP (make a request), Sleep agus Gmail nó Outlook (create a draft).

Síntí forbróra agus breiseáin siopa

Bain an ZIP amach agus léigh an treoir atá ann. Lódáil an síneadh brabhsálaí go háitiúil; seiceáil breiseáin siopa i siopa tástála ar dtús. Teastaíonn d’eochair Dev API féin. Soláthraíonn Shopware CLI faoi láthair.

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