Webhooki
Gotowy tekst sam trafia do Ciebie
Długi tekst powstaje kilka minut. Zamiast odpytywać nas co chwilę, podaj adres — wyślemy zdarzenie, gdy będzie gotowe. Podpisane i ponawiane.
Co przychodzi
POST /twoj-endpoint HTTP/1.1
X-Smart-Copy-Signature: t=1754899200,v1=5d41402abc4b2a76b9719d911017c592
Content-Type: application/json
{
"event": "text.completed",
"text_id": "b7f3…",
"order_id": "a91c…",
"topic": "Silnik elektryczny 7,5 kW",
"html": "<h2>…</h2>",
"characters": 4012
}Zdarzenia
text.completed Tekst jest napisany. W treści zdarzenia dostajesz gotowy HTML, obraz wyróżniający i link do publikacji w WordPressie, jeśli była włączona.
text.failed Generowanie się nie udało. Środki wracają na saldo automatycznie — zdarzenie mówi tylko, że tak się stało.
outline.ready Konspekt czeka na akceptację. Dotyczy zamówień, w których włączono zatwierdzanie konspektu przed pisaniem.
Dlaczego możesz im ufać
Podpis HMAC-SHA256
Każde żądanie niesie nagłówek z podpisem liczonym z treści i Twojego sekretu. Porównujesz go u siebie i wiesz, że to naprawdę my, a nie ktoś, kto zgadł adres.
Ponawianie
Gdy Twój serwer nie odpowie albo zwróci błąd, próbujemy ponownie z rosnącym odstępem. Krótka awaria po Twojej stronie nie gubi zdarzenia.
Znacznik czasu
Podpis obejmuje czas wysłania, więc możesz odrzucać żądania starsze niż kilka minut i zamknąć drogę na powtórzenie przechwyconego pakietu.
Adres per klucz
Każdy klucz API ma własny adres i własny sekret. Środowisko testowe wysyła gdzie indziej niż produkcyjne.
Podaj adres i sprawdź
Na kluczu testowym zdarzenia przychodzą tak samo jak na produkcyjnym, tylko za darmo.