Pređi na glavni sadržaj

API i webhook-ovi

Stranica API i webhook-ovi ima tri kartice: Domen ID, REST API i Webhook-ovi. Stranica je vezana za domen izabran na vrhu kontrolne table.

Domen ID​

Svaki domen ima svoj Domen ID. To je javni ključ koji se koristi u vašem kodu za ugradnju, pa je namerno vidljiv u izvornom kodu vaše stranice. Kartica Domen ID ga prikazuje zajedno sa kodom za ugradnju skripte spremnim za nalepljivanje:

<script src="https://cdn.optsens.com/optsens.min.js/YOUR_DOMAIN_ID"></script>

Kopirajte ID ili ceo kod sa ove kartice. Za postavljanje pogledajte Instalacija OptSens-a.

Generisanje novog Domen ID-ja​

Novi Domen ID možete generisati sa iste kartice.

Generisanje novog ID-ja prekida aktivne integracije

Trenutni Domen ID odmah prestaje da važi. Baner prestaje da se učitava na vašem sajtu dok ne ažurirate novi ID svuda gde ga koristite: u script tagu, Google Tag Manager-u, WordPress dodatku, Shopify aplikaciji i u svim REST API pozivima. Ažurirajte svoje podešavanje odmah nakon generisanja novog ID-ja.

REST API​

Kartica REST API dostupna je na planu Business. Na nižim planovima kartica je zaključana i traži unapređenje plana.

Potpuna referenca krajnjih tačaka, autentifikacija i ograničenja stope nalaze se u API referenci.

Webhook-ovi​

Webhook-ovi su takođe funkcija plana Business. Oni obaveštavaju vašu krajnju tačku u realnom vremenu kada se na domenu dogode događaji saglasnosti.

  • Dodajte do 5 webhook-ova po domenu.
  • Svaki webhook dobija tajni ključ za potpisivanje, prikazan jednom pri kreiranju. Čuvajte ga bezbedno.
  • Webhook možete da testirate, uključite ili isključite, pregledate njegov zapisnik isporuka i da regenerišete njegov tajni ključ.

Verifikacija potpisa​

Svaka isporuka je potpisana kako biste mogli da potvrdite da je stigla od OptSens-a. Zahtev nosi dva zaglavlja:

ZaglavljeNamena
X-OptSens-SignaturePotpis sadržaja, u obliku v1=<hex digest>
X-OptSens-TimestampVreme sa kojim je potpis izračunat

Potpisana poruka se sastoji od vremena, tačke i sirovog sadržaja zahteva. Izračunajte njen hex HMAC-SHA256 vašim tajnim ključem za potpisivanje i dodajte prefiks v1=:

v1=HMAC-SHA256(secret, timestamp + "." + body)

Uporedite to sa X-OptSens-Signature. Ako se poklapaju, isporuka je autentična. Regenerisanje tajnog ključa poništava stari. Ažurirajte svoj handler kada ga rotirate.