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

Żid "callback_url" ma' POST /api/v1/jobs, u Do4U jibgħat POST iffirmat (avveniment job.finished bl-istatus, il-krediti u l-link tar-riżultat - mhux ir-riżultat innifsu) hekk kif il-job jitlesta. Indirizzi pubbliċi biss fuq il-port 80 jew 443; nerġgħu nippruvaw sa 6 darbiet b'pawżi dejjem itwal.

Eżempju: oħloq job b'callback_url – u t-talba li Do4U jibgħat lil dak l-indirizz meta l-job jitlesta:

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

Iċċekkja l-header X-Do4U-Signature: t=<time>,v1=<hex>, fejn v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Irrifjuta ħinijiet qodma (eż. eqdem minn 5 minuti). Is-sigriet tiegħek jibda b'whsec_ u jintwera fil-paġna Ċwievet tal-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

Meta l-bilanċ tal-krediti ta' kont jinżel taħt il-limitu, Do4U jibgħat POST iffirmat wieħed lill-indirizz tal-webhook tal-kont. L-avveniment ma fih l-ebda data personali, biss il-bilanċ, il-limitu u l-ħin (UTC). Dak li jmiss jiġi biss wara li jerġgħu jiżdiedu l-krediti (xiri, krediti b'xejn ta' kull xahar jew voucher). Il-firma u s-sigriet huma l-istess bħal għal 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"}

Tissettja l-indirizz u l-limitu hawn: Ċwievet tal-API

n8n

Workflow lest: webhook jirċievi s-sejħa minn Do4U, jiċċekkja l-firma, iġib ir-riżultat u jgħaddih lill-pass li jmiss tiegħek.

Niżżel il-mudell ta' n8n (JSON)

Mudell, għadu mhux ittestjat f'istanza reali ta' n8n jew Make – jekk jogħġbok ittestja l-verifika tal-firma qabel tużah.

F'n8n: Workflows → Import from file. Imbagħad daħħal is-sigriet tiegħek fin-node "Check signature" u ċ-ċavetta tal-API tiegħek f'"Do4U: get result", attiva l-workflow u uża l-URL tal-produzzjoni tal-webhook bħala callback_url. n8n self-hosted jeħtieġ il-varjabbli tal-ambjent NODE_FUNCTION_ALLOW_BUILTIN=crypto għall-verifika tal-firma.

Make

1. Żid il-modulu Webhooks → Custom webhook bħala t-trigger u ixgħel "JSON pass-through" u "Get request headers" fl-issettjar avvanzat tiegħu.
2. Uża l-indirizz ta' dan il-webhook bħala callback_url.
3. Iċċekkja l-firma: qabbel v1 mill-header X-Do4U-Signature ma' sha256(t + "." + raw body; hex; is-sigriet tiegħek).
4. Żid HTTP → Make a request: GET fuq result_url bil-header Authorization: Bearer <your API key>.
5. Uża l-qasam result fil-moduli li jmiss tiegħek.

Mudell, għadu mhux ittestjat f'istanza reali ta' n8n jew Make – jekk jogħġbok ittestja l-verifika tal-firma qabel tużah.

Riċetti: għaqqad l-għodod

Riċetta tħaddem minn 2 sa 4 għodod waħda wara l-oħra bħala job wieħed. Ibgħat "recipe" minflok "tool": jew l-isem ta' riċetta lesta jew lista ta' passi. It-test imur fl-ewwel pass; ir-riżultat ta' kull pass huwa t-test għall-pass li jmiss. GET /api/v1/recipes jelenka r-riċetti lesti, l-għodod li tista' tuża u l-qasam li kull għodda tgħaddi.

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

Tieħu stima waħda għall-passi kollha (credits_estimate). Dak l-ammont jiġi riżervat fil-bidu. Wara kull pass l-użu reali jiġi rreġistrat u l-bqija jibqa' riżervat sal-aħħar, imbagħad jiġi rilaxxat. Pass li jfalli ma jiswa xejn, il-passi li jkun fadal jinqabżu, u l-passi li diġà tlestew jiġu ddebitati.

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} juri kull pass bl-istatus tiegħu (pending, queued, running, done, failed, skipped), il-krediti tiegħu, avviż input_shortened jekk it-test kellu jitqassar għall-għodda li jmiss, u r-riżultat ta' kull pass ladarba tintemm ir-riċetta. B'no_store ir-riżultati jintwerew darba. callback_url jinbeda darba, fl-aħħar tar-riċetta.

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.

Wieġeb l-emails mingħajr ma tibdel l-inbox tiegħek

Do4U ma jħaddimx inbox u qatt ma jaħżen data ta' aċċess għall-mailbox tiegħek. Żewġ modi kif xorta tieħu abbozzi ta' tweġibiet:

S1 – Mudell għal n8n jew Make

1. Trigger: email ġdida fil-mailbox tiegħek (IMAP trigger f'n8n jew Make – id-data ta' aċċess tibqa' hemm)
2. POST /api/v1/jobs bl-għodda support_reply, it-test tal-email u no_store: true
3. Stenna ftit sekondi u ġib GET /api/v1/jobs/{id} sakemm l-istatus ikun done
4. Oħloq abbozz fil-mailbox tiegħek bit-test minn result.reply (modulu Gmail jew Outlook)

Niżżel il-mudell ta' n8n (JSON)

F'Make, ibni l-istess xenarju mill-moduli Email (watch emails), HTTP (make a request), Sleep u Gmail jew Outlook (create a draft).

Estensjonijiet għall-iżviluppaturi u plugins għall-ħwienet

Estratta ż-ZIP u aqra l-gwida inkluża. Tella' l-estensjoni tal-browser lokalment; iċċekkja l-plugins tal-ħwienet f'ħanut tat-test l-ewwel. Teħtieġ iċ-ċavetta Dev API tiegħek stess. Shopware bħalissa jipprovdi CLI.

• Do4U għal WordPress (ZIP)
• Chrome / Firefox · Dev (ZIP)
• WooCommerce · Dev (ZIP)
• Shopware · CLI · Dev (ZIP)