Dokumentacja API

Dzięki API Do4U korzystasz z tych samych narzędzi co na stronie, bezpośrednio z własnego oprogramowania: streszczanie, porównywanie, odpowiedzi dla obsługi klienta, teksty alternatywne, redagowanie i tłumaczenie. Każde zapytanie przetwarzamy na własnych serwerach w Polsce, w UE.

Adres bazowy: https://do4u.eu/api/v1

Opis OpenAPI 3.1 (JSON) – Opis tego API do odczytu maszynowego dla generatorów kodu i narzędzi takich jak Postman czy Insomnia. Bez klucza.

Uwierzytelnianie

Utwórz klucz w sekcji „Klucze API" w swoim koncie. Wysyłaj go z każdym zapytaniem w nagłówku Authorization: Bearer <klucz> (lub X-API-Key: <klucz>). Zachowaj klucz w tajemnicy i nigdy nie umieszczaj go na stronie internetowej. Możesz go w każdej chwili unieważnić.

Jak to działa

Zadania działają w tle. Tworzysz zadanie i od razu dostajesz jego identyfikator (HTTP 202). Potem pobierasz zadanie, aż status będzie done lub failed. Pytaj co 2–5 sekund; większość zadań trwa kilka sekund.

Endpointy

Przykład

Utwórz zadanie, a potem pobierz wynik:

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

Pola zapytania POST /jobs

Bezpieczne ponawianie zapytań (Idempotency-Key)

Wysyłaj przy POST /jobs nagłówek Idempotency-Key, na przykład losowy UUID dla każdego zadania (od 1 do 255 drukowalnych znaków ASCII). Jeśli połączenie się zerwie i wyślesz to samo zapytanie z tym samym Idempotency-Key i tym samym kluczem API w ciągu 24 godz., dostaniesz tę samą odpowiedź: to samo zadanie, bez drugiego zadania i bez drugiego obciążenia. Odpowiedź ma wtedy nagłówek Idempotent-Replayed: true. Do każdego nowego zadania użyj nowej wartości. Jeśli wyślesz tę samą wartość z innym zapytaniem, dostaniesz 422 idempotency_conflict. Błędy nie są zapisywane: po błędzie możesz wysłać zapytanie ponownie z tą samą wartością.

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

Narzędzia i opcje

Status zadania

queued i running: zadanie trwa (position i wait_seconds pomagają w czekaniu). done: result zawiera pola narzędzia. failed: nic nie zostało pobrane (credits wynosi 0); error.code podaje powód: address_blocked (Do4U nie otwiera tego adresu, na przykład prywatnego lub wewnętrznego; wyślij zamiast tego tekst lub HTML), input_too_large (skróć dane), image_unavailable lub job_failed. expired: wynik nie jest już przechowywany.

Webhooki

Dodaj "callback_url" do POST /api/v1/jobs, a Do4U wyśle podpisany POST (zdarzenie job.finished ze statusem, kredytami i linkiem do wyniku - bez samego wyniku), gdy zadanie będzie gotowe. Tylko adresy publiczne na porcie 80 lub 443; ponawiamy do 6 razy z rosnącymi przerwami.

Przykład: utwórz zadanie z callback_url – oraz żądanie, które Do4U wyśle na ten adres, gdy zadanie będzie gotowe:

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

Sprawdź nagłówek X-Do4U-Signature: t=<czas>,v1=<hex>, gdzie v1 = HMAC-SHA256(sekret, "<czas>.<surowa treść>"). Odrzucaj stare znaczniki czasu (np. starsze niż 5 minut). Twój sekret zaczyna się od whsec_ i znajdziesz go na stronie Klucze 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

Gdy saldo kredytów konta spadnie poniżej progu, Do4U wysyła jednorazowo podpisany POST na adres webhooka konta. Zdarzenie nie zawiera danych osobowych, tylko saldo, próg i czas (UTC). Kolejne przyjdzie dopiero wtedy, gdy znowu dojdą kredyty (zakup, darmowe kredyty miesiąca lub kupon). Podpis i klucz są takie same jak przy 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"}

Adres i próg ustawisz tutaj: Klucze API

n8n

Gotowy workflow: webhook odbiera wywołanie z Do4U, sprawdza podpis, pobiera wynik i przekazuje go do twojego następnego kroku.

Pobierz szablon dla n8n (JSON)

Szablon jeszcze nieprzetestowany w prawdziwej instancji n8n ani Make – przed użyciem przetestuj sprawdzanie podpisu.

W n8n: Workflows → Import from file. Następnie wpisz swój sekret w węźle „Check signature", a klucz API w „Do4U: get result", aktywuj workflow i użyj adresu Production URL webhooka jako callback_url. Samodzielnie hostowane n8n potrzebuje do sprawdzenia podpisu zmiennej środowiskowej NODE_FUNCTION_ALLOW_BUILTIN=crypto.

Make

1. Dodaj moduł Webhooks → Custom webhook jako wyzwalacz i włącz w jego ustawieniach zaawansowanych „JSON pass-through" oraz „Get request headers".
2. Użyj adresu tego webhooka jako callback_url.
3. Sprawdź podpis: porównaj v1 z nagłówka X-Do4U-Signature z sha256(t + "." + surowa treść; hex; twój sekret).
4. Dodaj HTTP → Make a request: GET na result_url z nagłówkiem Authorization: Bearer <Twój klucz API>.
5. Użyj pola result w kolejnych modułach.

Szablon jeszcze nieprzetestowany w prawdziwej instancji n8n ani Make – przed użyciem przetestuj sprawdzanie podpisu.

Przepisy: łączenie narzędzi

Przepis uruchamia od 2 do 4 narzędzi jedno po drugim jako jedno zadanie. Wyślij „recipe” zamiast „tool”: nazwę gotowego przepisu albo listę kroków. Tekst trafia do pierwszego kroku; wynik każdego kroku jest tekstem dla następnego. GET /api/v1/recipes pokazuje gotowe przepisy, dostępne narzędzia i pole, które każde narzędzie przekazuje dalej.

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

Dostajesz jedną wycenę wszystkich kroków (credits_estimate). Ta kwota jest rezerwowana na początku. Po każdym kroku księgowane jest prawdziwe zużycie, reszta zostaje zarezerwowana do końca, a potem jest zwalniana. Nieudany krok nic nie kosztuje, pozostałe kroki są pomijane, a zakończone już kroki są rozliczane.

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} pokazuje każdy krok ze statusem (pending, queued, running, done, failed, skipped), jego kredytami, uwagą input_shortened, gdy tekst trzeba było skrócić dla następnego narzędzia, oraz wynikiem każdego kroku, gdy przepis się zakończy. Z no_store wyniki są pokazywane jeden raz. callback_url uruchamia się dokładnie raz, na końcu przepisu.

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

Błędy

Błędy mają zawsze tę samą postać: {"error": {"code": "...", "message": "..."}}. Przy 429 i 503 nagłówek Retry-After mówi, ile sekund odczekać.

Limity

• 60 zapytań na minutę na klucz i 120 na konto.
• Jednocześnie otwarte zadania na konto: Free 3, Starter 3, Standard 5, Pro 10, strona i API razem.
• Dane wejściowe: Free 8 000 znaków, płatne pakiety 30 000. Niższe limity narzędzi: compare 20 000, alt_text 1 000, translate 12 000 (compare: oba teksty razem).
• Klucze API: Free 1, Starter 1, Standard 5, Pro 10.

Kredyty

Nowe zadanie pokazuje szacunek (credits_estimate); pobierane jest rzeczywiste zużycie (credits). Nieudane zadania nic nie kosztują. Najpierw zużywane są darmowe kredyty.

Dane

Dane wejściowe i wyniki przechowujemy 7 dni (Free) lub 30 dni (płatne pakiety), potem je usuwamy. Obrazy usuwamy zaraz po przetworzeniu. Wyniki są generowane przez AI: sprawdź je przed użyciem.

Odpowiadaj na e-maile bez zmiany skrzynki

Do4U nie prowadzi skrzynki i nigdy nie przechowuje danych dostępu do twojej poczty. Dwa sposoby, aby mimo to dostawać szkice odpowiedzi:

S1 – Szablon dla n8n lub Make

1. Wyzwalacz: nowy e-mail w twojej skrzynce (wyzwalacz IMAP w n8n lub Make – dane dostępu zostają tam)
2. POST /api/v1/jobs z tool support_reply, tekstem e-maila i no_store: true
3. Odczekaj kilka sekund i pobieraj GET /api/v1/jobs/{id}, aż status będzie done
4. Utwórz w skrzynce szkic z tekstem z result.reply (moduł Gmail lub Outlook)

Pobierz szablon n8n (JSON)

W Make zbudujesz ten sam scenariusz z modułów E-mail (obserwuj e-maile), HTTP (wyślij żądanie), Sleep oraz Gmail lub Outlook (utwórz szkic).

Rozszerzenia Dev i wtyczki sklepowe

Rozpakuj ZIP i przeczytaj instrukcję. Załaduj rozszerzenie lokalnie; wtyczki sprawdź najpierw w sklepie testowym. Wymagany jest własny klucz Dev API. Shopware udostępnia obecnie CLI.

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