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.

Webhookid

Lisa päringule POST /api/v1/jobs väli "callback_url" ja Do4U saadab allkirjastatud POST-päringu (sündmus job.finished koos oleku, krediitide ja tulemuse lingiga – mitte tulemuse endaga) kohe, kui töö on valmis. Ainult avalikud aadressid pordil 80 või 443; proovime uuesti kuni 6 korda üha pikenevate pausidega.

Näide: loo töö väljaga callback_url – ja päring, mille Do4U sellele aadressile saadab, kui töö on valmis:

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

Kontrolli päist X-Do4U-Signature: t=<time>,v1=<hex>, kus v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Lükka vanad ajad tagasi (nt vanemad kui 5 minutit). Sinu saladus algab eesliitega whsec_ ja seda näidatakse lehel API-võtmed.

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

Kui konto krediidisaldo langeb alla läve, saadab Do4U konto webhooki aadressile ühe allkirjastatud POST-päringu. Sündmus ei sisalda isikuandmeid, ainult saldot, läve ja aega (UTC). Järgmine tuleb alles pärast seda, kui krediite on uuesti lisatud (ost, igakuised tasuta krediidid või kinkekood). Allkiri ja saladus on samad mis sündmuse job.finished puhul.

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

Aadressi ja läve määrad siin: API-võtmed

n8n

Valmis töövoog: webhook võtab Do4U kõne vastu, kontrollib allkirja, toob tulemuse ja annab selle sinu järgmisele sammule.

Laadi alla n8n mall (JSON)

Mall, mida pole veel päris n8n- ega Make-keskkonnas testitud – palun testi allkirja kontrolli enne kasutamist.

n8n-is: Workflows → Import from file. Seejärel sisesta oma saladus sõlme "Check signature" ja oma API-võti sõlme "Do4U: get result", aktiveeri töövoog ja kasuta väljana callback_url webhooki tootmis-URL-i. Isehostitud n8n vajab allkirja kontrolliks keskkonnamuutujat NODE_FUNCTION_ALLOW_BUILTIN=crypto.

Make

1. Lisa päästikuks moodul Webhooks → Custom webhook ja lülita selle täpsemates seadetes sisse "JSON pass-through" ja "Get request headers".
2. Kasuta selle webhooki aadressi väljana callback_url.
3. Kontrolli allkirja: võrdle päises X-Do4U-Signature olevat väärtust v1 väärtusega sha256(t + "." + raw body; hex; sinu saladus).
4. Lisa HTTP → Make a request: GET aadressile result_url päisega Authorization: Bearer <your API key>.
5. Kasuta välja result oma järgmistes moodulites.

Mall, mida pole veel päris n8n- ega Make-keskkonnas testitud – palun testi allkirja kontrolli enne kasutamist.

Retseptid: tööriistade ahelad

Retsept käivitab 2–4 tööriista üksteise järel ühe tööna. Saada "tool" asemel "recipe": kas valmisretsepti nimi või sammude loend. Tekst läheb esimesse sammu; iga sammu tulemus on järgmise sammu tekst. GET /api/v1/recipes loetleb valmisretseptid, kasutatavad tööriistad ja välja, mille iga tööriist edasi annab.

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

Saad kõigi sammude kohta ühe hinnangu (credits_estimate). See summa broneeritakse alguses. Pärast iga sammu kirjendatakse tegelik kasutus ja ülejäänu jääb lõpuni broneerituks, seejärel see vabastatakse. Ebaõnnestunud samm ei maksa midagi, ülejäänud sammud jäetakse vahele ja juba valmis sammude eest võetakse tasu.

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} näitab iga sammu koos selle olekuga (pending, queued, running, done, failed, skipped), krediitidega, teatega input_shortened, kui teksti tuli järgmise tööriista jaoks lühendada, ning iga sammu tulemusega, kui retsept on lõppenud. Valikuga no_store näidatakse tulemusi üks kord. callback_url käivitub ühe korra, retsepti lõpus.

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.

Vasta e-kirjadele ilma postkasti vahetamata

Do4U ei halda postkasti ega salvesta kunagi sinu postkasti ligipääsuandmeid. Kaks võimalust vastuste mustandeid siiski saada:

S1 – mall n8n või Make jaoks

1. Päästik: uus e-kiri sinu postkastis (IMAP-päästik n8n-is või Make'is – ligipääsuandmed jäävad sinna)
2. POST /api/v1/jobs tööriistaga support_reply, e-kirja tekstiga ja väärtusega no_store: true
3. Oota mõni sekund ja too GET /api/v1/jobs/{id}, kuni olek on done
4. Loo oma postkasti mustand tekstiga väljast result.reply (Gmaili või Outlooki moodul)

Laadi alla n8n mall (JSON)

Make'is ehita sama stsenaarium moodulitest Email (watch emails), HTTP (make a request), Sleep ja Gmail või Outlook (create a draft).

Arendajalaiendused ja e-poe pluginad

Paki ZIP lahti ja loe kaasasolevat juhendit. Laadi brauserilaiendus kohalikult; kontrolli e-poe pluginaid esmalt testpoes. Vajalik on sinu enda Dev API-võti. Shopware pakub praegu CLI-d.

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