Webhook: mi guramo
Čim tekst izađe, šaljemo POST sa punim sadržajem članka na vašu adresu. Uz telo idu potpis i identifikator sajta, pa možete da proverite da zahtev stvarno dolazi od nas.
Integracija
Webhook i javni API
Ako koristite sistem za koji nemamo namensku integraciju — custom CMS, Framer, Notion, interna aplikacija — postoje dva puta: mi guramo, ili vi povlačite.
Šta treba od vas
- Za webhook: HTTPS adresa koja prima POST i, po želji, secret za proveru potpisa.
- Za javni API: ništa — mi izdamo ključ i vi ga stavite u zaglavlje.
Šta stiže na odredište
- Isti tekst u tri oblika: HTML, markdown i čist tekst
- Naslov, meta opis, slug, kategorija i ključne reči
- Naslovna slika sa alt tekstom, na apsolutnoj adresi
- JSON-LD blok i naš SEO skor teksta
- Vreme objave
Kako radi
Tok objave, korak po korak
Javni API: vi povlačite
GET na /api/v1/posts vraća listu objavljenih tekstova, a /api/v1/posts/{slug} pun tekst. Ključ je vezan za jedan sajt, pa ne postoji način da vidi tuđi sadržaj.
Izmena stiže sama
Kad tekst ispravimo, webhook dobija isti članak sa oznakom da je izmena, a API vraća novu verziju. Vezivanje ide po našem identifikatoru, ne po slug-u, pa promena adrese ništa ne lomi.
Granice
Šta ova integracija ne radi
Stoji na stranici namerno. Bolje da se vidi sada nego posle prve objave.
- Webhook ide na HTTPS adrese koje su javno dostupne. Interne mreže i lokalne adrese namerno odbijamo.
- Slike ostaju na našem hostu i za webhook i za API — ako ih hoćete kod sebe, preuzmite ih pri obradi.
- Javni API je read-only. Nema upisa niti izmena kroz njega.
FAQ
Česta pitanja — Webhook i javni API
Kako proveravam da zahtev dolazi od vas?
Uz telo šaljemo HMAC-SHA256 potpis u zaglavlju i isti secret kao Bearer token. Možete proveravati potpis, koji pokriva i sadržaj, ili samo token ako vam treba nešto jednostavno.
Šta ako moj server ne odgovori?
Pokušavamo ponovo. Prolazne greške (mreža, 5xx, ograničenje broja zahteva) idu u novi pokušaj, a trajne (pogrešan potpis, nepostojeća ruta) se odmah prijave u panelu umesto da se ponavljaju.
Mogu li da koristim oba?
Da. Webhook za nove tekstove i API za istoriju je česta kombinacija — jedan sajt sme da ima više odredišta odjednom.
Ostale integracije
Sajt sme da ima više odredišta odjednom
WordPress Objava kroz zvanični REST API, uz application password. Bez plugina. Webflow Upis u CMS kolekciju preko Data API v2, draft ili odmah živo na sajtu. Ghost Admin API sa potpisanim tokenom, slike u Ghost biblioteku, tagovi. GitHub Markdown u repo statičkog sajta — Astro, Hugo, Next i slični. Prilagođena integracija Vaš sistem nije na spisku i nemate ko da piše kod? Integraciju pišemo mi, vi ne dirate ništa.
Sledeći korak
Spremni za organski rast?
Povežite bilo koji sajt — usluge, webshop ili blog. Plan se pravi sam, tekstovi se pišu i objavljuju po rasporedu, a prvi članak je besplatan.