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

Πρόσθεσε "callback_url" στο POST /api/v1/jobs και το Do4U στέλνει ένα υπογεγραμμένο POST (συμβάν job.finished με την κατάσταση, τα credits και τον σύνδεσμο του αποτελέσματος - όχι το ίδιο το αποτέλεσμα) μόλις ολοκληρωθεί η εργασία. Μόνο δημόσιες διευθύνσεις στη θύρα 80 ή 443· επαναλαμβάνουμε έως 6 φορές με αυξανόμενες παύσεις.

Παράδειγμα: δημιουργία εργασίας με callback_url – και το αίτημα που στέλνει το Do4U σε αυτή τη διεύθυνση όταν ολοκληρωθεί η εργασία:

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

Έλεγξε την κεφαλίδα X-Do4U-Signature: t=<time>,v1=<hex>, όπου v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Απόρριψε παλιές χρονικές στιγμές (π.χ. παλαιότερες από 5 λεπτά). Το μυστικό σου ξεκινά με whsec_ και εμφανίζεται στη σελίδα Κλειδιά 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

Όταν το υπόλοιπο credits ενός λογαριασμού πέσει κάτω από το όριο, το Do4U στέλνει ένα υπογεγραμμένο POST στη διεύθυνση webhook του λογαριασμού. Το συμβάν δεν περιέχει προσωπικά δεδομένα, μόνο το υπόλοιπο, το όριο και την ώρα (UTC). Το επόμενο ακολουθεί μόνο αφού προστεθούν ξανά credits (αγορά, μηνιαία δωρεάν credits ή κουπόνι). Η υπογραφή και το μυστικό είναι τα ίδια με το 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"}

Ορίζεις τη διεύθυνση και το όριο εδώ: Κλειδιά API

n8n

Έτοιμη ροή εργασίας: ένα webhook λαμβάνει την κλήση από το Do4U, ελέγχει την υπογραφή, παίρνει το αποτέλεσμα και το παραδίδει στο επόμενο βήμα σου.

Λήψη του προτύπου n8n (JSON)

Πρότυπο, που δεν έχει ακόμα δοκιμαστεί σε πραγματική εγκατάσταση n8n ή Make – δοκίμασε τον έλεγχο της υπογραφής πριν το χρησιμοποιήσεις.

Στο n8n: Workflows → Import from file. Μετά πληκτρολόγησε το μυστικό σου στον κόμβο "Check signature" και το κλειδί API σου στον "Do4U: get result", ενεργοποίησε τη ροή εργασίας και χρησιμοποίησε το production URL του webhook ως callback_url. Το n8n που φιλοξενείς μόνος σου χρειάζεται τη μεταβλητή περιβάλλοντος NODE_FUNCTION_ALLOW_BUILTIN=crypto για τον έλεγχο της υπογραφής.

Make

1. Πρόσθεσε την ενότητα Webhooks → Custom webhook ως trigger και ενεργοποίησε τα "JSON pass-through" και "Get request headers" στις προχωρημένες ρυθμίσεις της.
2. Χρησιμοποίησε τη διεύθυνση αυτού του webhook ως callback_url.
3. Έλεγξε την υπογραφή: σύγκρινε το v1 από την κεφαλίδα X-Do4U-Signature με το sha256(t + "." + raw body; hex; το μυστικό σου).
4. Πρόσθεσε HTTP → Make a request: GET στο result_url με την κεφαλίδα Authorization: Bearer <your API key>.
5. Χρησιμοποίησε το πεδίο result στις επόμενες ενότητές σου.

Πρότυπο, που δεν έχει ακόμα δοκιμαστεί σε πραγματική εγκατάσταση n8n ή Make – δοκίμασε τον έλεγχο της υπογραφής πριν το χρησιμοποιήσεις.

Συνταγές: αλυσίδα εργαλείων

Μια συνταγή εκτελεί 2 έως 4 εργαλεία το ένα μετά το άλλο ως μία εργασία. Στείλε "recipe" αντί για "tool": είτε το όνομα μιας έτοιμης συνταγής είτε μια λίστα βημάτων. Το κείμενο πηγαίνει στο πρώτο βήμα· το αποτέλεσμα κάθε βήματος είναι το κείμενο για το επόμενο βήμα. Το GET /api/v1/recipes απαριθμεί τις έτοιμες συνταγές, τα εργαλεία που μπορείς να χρησιμοποιήσεις και το πεδίο που περνά κάθε εργαλείο παρακάτω.

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

Παίρνεις μία εκτίμηση για όλα τα βήματα (credits_estimate). Αυτό το ποσό δεσμεύεται στην αρχή. Μετά από κάθε βήμα καταγράφεται η πραγματική χρήση και το υπόλοιπο μένει δεσμευμένο μέχρι το τέλος, και τότε απελευθερώνεται. Ένα βήμα που αποτυγχάνει δεν κοστίζει τίποτα, τα υπόλοιπα βήματα παραλείπονται και τα βήματα που είχαν ήδη ολοκληρωθεί χρεώνονται.

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} δείχνει κάθε βήμα με την κατάστασή του (pending, queued, running, done, failed, skipped), τις πιστώσεις του, μια ειδοποίηση input_shortened αν το κείμενο έπρεπε να μειωθεί για το επόμενο εργαλείο, και το αποτέλεσμα κάθε βήματος μόλις τελειώσει η συνταγή. Με το no_store τα αποτελέσματα εμφανίζονται μία φορά. Το callback_url ενεργοποιείται μία φορά, στο τέλος της συνταγής.

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.

Απάντησε σε email χωρίς να αλλάξεις τα εισερχόμενά σου

Το Do4U δεν διαχειρίζεται εισερχόμενα και δεν αποθηκεύει ποτέ στοιχεία πρόσβασης για το γραμματοκιβώτιό σου. Δύο τρόποι για να πάρεις παρ' όλα αυτά προσχέδια απαντήσεων:

S1 – Πρότυπο για n8n ή Make

1. Έναρξη: ένα νέο email στο γραμματοκιβώτιό σου (IMAP trigger στο n8n ή στο Make – τα στοιχεία πρόσβασης μένουν εκεί)
2. POST /api/v1/jobs με εργαλείο support_reply, το κείμενο του email και no_store: true
3. Περίμενε λίγα δευτερόλεπτα και πάρε το GET /api/v1/jobs/{id} μέχρι η κατάσταση να γίνει done
4. Δημιούργησε ένα προσχέδιο στο γραμματοκιβώτιό σου με το κείμενο από το result.reply (ενότητα Gmail ή Outlook)

Λήψη του προτύπου n8n (JSON)

Στο Make, φτιάξε το ίδιο σενάριο από τις ενότητες Email (watch emails), HTTP (make a request), Sleep και Gmail ή Outlook (create a draft).

Επεκτάσεις για προγραμματιστές και πρόσθετα καταστημάτων

Εξαγωγή του ZIP και ανάγνωση του οδηγού που περιλαμβάνεται. Φόρτωσε την επέκταση του browser τοπικά· έλεγξε τα πρόσθετα καταστημάτων πρώτα σε δοκιμαστικό κατάστημα. Απαιτείται δικό σου κλειδί Dev API. Το Shopware παρέχει προς το παρόν CLI.

• Το Do4U για WordPress (ZIP)
• Chrome / Firefox · Dev (ZIP)
• WooCommerce · Dev (ZIP)
• Shopware · CLI · Dev (ZIP)