Webhookovi u odjeljku "Video avatari": obavijest vašem poslužitelju kada je video spreman

Webhookovi u odjeljku "Video avatari" je način da saznate da je video spreman, bez ručnog osvježavanja stranice: čim je video dovršen, na adresu vašeg poslužitelja šalje se POST zahtjev, a vaš poslužitelj sam odlučuje što će učiniti sljedeće - napisati poveznicu u bazu podataka, poslati datoteku klijentu ili započeti sljedeći korak. Kartica je potrebna onima koji video zapise izrađuju u serijama ili integriraju generiranje avatara u svoj proizvod: umjesto beskrajnih provjera "spreman ili još nisam", jedna kratka obavijest stiže točno u pravom trenutku.

Zašto je to uopće potrebno?

Renderiranje videozapisa nije trenutna operacija i nema smisla čekati ga u otvorenoj kartici. Prema mjerenjima platforme od 09/07/2026, pet sekundi Kling 3.0 video u 1080p smatra se prosječno 115 sekundi, au 95% slučajeva stane u 165. Za Sora 2, isti zadatak traje u prosjeku oko 145 sekundi. Ako provjeravate status svakih nekoliko sekundi, deseci praznih zahtjeva pojavljuju se u jednom videu; Webhook dolazi samo jednom - kada se rezultat stvarno pojavi.

Volumen također govori sam za sebe. Prema dnevniku generiranja platforme, tijekom 30 dana (3. rujna – 2. listopada 2026.) započela su 3.292 videozadatka, od kojih je 2.369 uspješno završeno. Video zapisi se broje u pozadini i završavaju u različito vrijeme - to se ne može pratiti ručno, a uredan rukovatelj obavijestima rješava sam problem.

Što radi kartica "Webhooks"?

Sve je u isporuci obavijesti, bez magije. Registrirate adresu, odaberete na koje ćete se događaje pretplatiti i dobijete tajnu pretplate. Popis registriranih krajnjih točaka pohranjuje se upravo tamo: možete vidjeti adresu, odabrane događaje, status i ima li krajnja točka tajnu. Tajna se može ponovno objaviti (stara će odmah prestati raditi) ili se krajnja točka može u potpunosti izbrisati.

Događaj dolazi samo iz vaših videa: tuđi video neće izaći, čak i ako je prebrojan u istom trenutku. Tu je i dnevnik isporučenih događaja - zgodno je provjeriti je li nešto doista stiglo do vašeg poslužitelja.

Kako započeti – korak po korak

1. Otvoreni odjeljak "Video avatari" i webhook panel na izravnu adresu /ru/avatars?tab=webhooks.
2. Prijavite se na svoj račun: postavka nije dostupna gostima; kada se klikne, otvorit će se prozor za prijavu.
3. U polje "Adresa krajnje točke" unesite javnu HTTPS adresu vašeg poslužitelja, na primjer https://example.com/avatar-webhook. HTTP neće raditi - isporuka i potpisivanje dizajnirani su za siguran kanal.
4. Označite tražene događaje. Ako ništa ne odaberete, bit ćete pretplaćeni na sve događaje odjednom.
5. Kliknite "Dodaj krajnju točku". Odmah nakon izrade pojavit će se tajna pretplate - kopirajte je i spremite za sebe: neće se ponovno prikazati.
6. Ako još nemate vlastiti poslužitelj, kliknite "Zamijenite našeg prijemnika" - tada će se obavijesti prikupljati u dnevniku isporučenih događaja izravno na kartici.

Kako se uvjeriti da je zahtjev naš, a ne lažan

Svaki zahtjev prati zaglavlje potpisa - to je HMAC-SHA256, izračunato iz sirovog tijela zahtjeva kao vaša tajna. S vaše strane prebrojite isti potpis i usporedite: ako ne odgovara, odbacujemo zahtjev. Naš primatelj radi upravo to i na netočan potpis odgovara s 401. Čuvajte tajnu na poslužitelju, u varijablama okruženja, a ne u kodu klijenta.

Što dolazi u zahtjevu

Tijelo je obični JSON s vrstom događaja i podacima entiteta. Na primjer, za gotov video, ovo je događaj BLK0 s video identifikatorom unutra. Potpuni popis dostupnih vrsta događaja prikazan je na kartici: možete ga sortirati i ostaviti samo ono što vaša usluga stvarno treba.

Koliko košta

Registracija krajnje točke, tajno ponovno izdavanje, brisanje i zapisnik događaja ne otpisuju tokene - ovo je postavka obavijesti, a ne generiranje. Tokeni se troše samo na sam video: cijena u tokenima vidljiva je prije pokretanja, a ako zadatak ne uspije, vraća se ono što je otpisano. Nema pretplate: novi korisnici dobivaju početne tokene za svoje prve testove.

S čime kombinirati

• "Grupni zadaci" — pokretanje desetaka videa s jednim zadatkom; Webhook će eliminirati potrebu za ručnom kontrolom spremnosti.
• "Medijska biblioteka" — pohranjivanje izvornih kodova i gotovih datoteka.
• "Video prijevod" I "Rezanje klipa" — sljedeći koraci nakon generacije.

Često postavljana pitanja

Koja je adresa prikladna za webhook?

Samo javni HTTPS. Lokalne adrese i HTTP nisu prihvaćeni: obavijest mora ići preko sigurnog kanala, a vaš poslužitelj mora biti dostupan izvana.

Je li moguće primati obavijesti ako nema poslužitelja?

Da. Kliknite "Zamijenite naš prijemnik" - događaji će se akumulirati u dnevniku "Dostavljeni događaji" na kartici, mogu se pregledati bez vaše pozadine.

Što učiniti ako se potpis ne slaže?

Provjerite čitate li HMAC-SHA256 iz neobrađenog tijela zahtjeva (a ne iz raščlanjenog JSON-a) i koristite li trenutnu tajnu: nakon ponovnog izdavanja, stara odmah prestaje raditi.

Je li ovo plaćeno?

Postavljanje web-dojavnika ne otpisuje tokene. Tokeni se troše samo na generiranje videa - njihova cijena je vidljiva prije lansiranja; Nema pretplate, novi korisnici dobivaju početne tokene.