# Partner API: upravljanje ključev in webhookov

Canonical: https://staystryk.com/sl/documentation/partner-api/
Language: sl
Updated: 2026-11-12

Tako v STRYK ustvariš ključe API z natanko potrebnimi pravicami in nastaviš webhooke za Partner API. Končne točke so v razvijalskem portalu.

## Preden začneš

Potrebuješ pravico Upravljanje kanalov. Samo s to pravico vidiš vrstico API na strani Kanali.

Ugotovi, katera področja mora integracija brati ali pisati. Ključ dobi samo te pravice.

Integracija kliče Partner API s svojega strežnika. Ključa nikoli ne vstavljaj v kodo brskalnika ali v aplikacijo. Krajišča, parametre in primere najdeš v Dokumentacija za razvijalce. Tam razlaga oddelek Avtentikacija in obsegi, kaj dovoli vsaka pravica.

Webhooki potrebujejo prejemnika z naslovom, ki se začne z https://.

## Odpri API

Kanali

Pod Lastne povezave izberi vrstico API z dodatkom „Ključi API in webhooki“. Pogovorno okno API se odpre.

Izberi zavihek Ključi API ali Webhooks. Z Dokumentacija za razvijalce v glavi pogovornega okna odpreš razvijalski portal.

Pogovorno okno API v zavihku Ključi API s ključem Stran za rezervacije, njegovimi pravicami, zadnjo uporabo in stanjem Aktivno.

Zavihka Ključi API in Webhooks

Ključi s pravicami

Dejanja ključa

## Ustvari ključ API

KanaliAPIKljuči API

Izberi Ustvari ključ API. Pogovorno okno Ustvari ključ API se odpre.

Vpiši Ime, na primer „Stran za rezervacije“.

Pod Pravice izberi predlogo: Samo branje (branje vseh področij), Branje in pisanje (pisanje, kjer je mogoče) ali Po meri. Pri Po meri za vsako področje izbereš Brez dostopa, Branje ali Pisanje. Področja so Hotel in sobe, Razpoložljivost, Cene in tarife, Rezervacije, Gostje, Plačila in Računi. Pisanje vključuje Branje. Računi so davčni dokumenti hotela in jih je prek API mogoče samo brati.

Neobvezno: odpri Napredno. Izberi Potek: Brez poteka, 30 dni, 90 dni, 1 leto ali Datum (od jutri, največ tri leta). Pod Omejitev IP vpiši v vsako vrstico naslov ali omrežje CIDR, največ 20. Prazno pomeni, da so dovoljeni vsi naslovi. Pod Opomba hraniš interno opombo.

Izberi Ustvari. STRYK prikaže Ključ API ustvarjen s ključem in opozorilo Vidno samo zdaj.

Kopiraj ključ in ga shrani na primer v upravitelj gesel. Izberi Končano.

STRYK celoten ključ prikaže samo enkrat. Če ga nisi shranil, ključ ustvari znova.

## Upravljanje ključev

KanaliAPIKljuči API

Seznam pri vsakem ključu prikazuje Ime, začetek ključa, Pravice, Ustvarjeno, Nazadnje uporabljeno, Potek in stanje: Aktivno, Kmalu poteče, Preklicano ali Potekel. Izberi ključ, da vidiš Pravice, Potek, Dovoljeni naslovi IP, Omejitev zahtev (zahteve na minuto), Uporaba, Nedavne zahteve in Zgodovino.

Odpri v vrstici meni Možnosti.

Izberi Znova ustvari, če mora integracija dobiti nov ključ z istimi pravicami. Pod Dosedanji ključ izberi Stari ključ velja še 24 h, da lahko integracijo preklopiš, ali Takoj prekliči. Potrdi z Znova ustvari. STRYK novi ključ prikaže enkrat.

Izberi Prekliči in potrdi Prekličem ključ API?, da ključ takoj blokiraš. STRYK zahtevke s tem ključem zavrne.

## Nastavitev webhookov

KanaliAPIWebhooks

Webhook po HTTPS podpisano pošlje izbrane dogodke tvojim sistemom.

Izberi Ustvari webhook. Pogovorno okno Nov webhook se odpre.

Vpiši URL prejemnika, na primer https://crm.nordlicht.invalid/hooks/stryk. Naslov se mora začeti z https://.

Neobvezno: vpiši Opis, na primer „Rezervacije v naš CRM“.

Pod Dogodki izberi vsaj enega: Rezervacija ustvarjena, Rezervacija spremenjena, Rezervacija preklicana, Gost spremenjen, Razpoložljivost spremenjena, Cena spremenjena, Plačilo spremenjeno ali Stanje sobe spremenjeno. S Izberi vse in Počisti izbiro izbereš vse ali nobenega.

Izberi Ustvari webhook. STRYK prikaže Tvoja skrivnost za podpisovanje enkrat.

Skrivnost shrani v svojem prejemniku. Kako prejemnik preveri podpis, opisuje razvijalska dokumentacija v razdelku Webhooki in preverjanje podpisa.

Izberi webhook in nato Pošlji testni dogodek. STRYK sporoči „Testni dogodek se dostavlja.“

## Upravljanje webhookov

Ort: Kanali \> API \> Webhooki, izberi webhook

S stikalom Dostava aktivna webhook začasno ustaviš ali aktiviraš. Ustavljeni webhooki ne prejmejo dogodkov. Po aktiviranju se dostava začne z novimi dogodki.

Zadnjih 7 dni, Zadnji uspeh in Zadnja napaka prikazujejo stanje. Pod Dostave vidiš vsako dostavo s Stanje HTTP in Poskusi. S Pošlji znova ponovno pošlješ dostavo.

Obnovi skrivnost ustvari novo skrivnost. Prejšnja ostane veljavna še 24 ur, da lahko prejemnik preklopiš.

S Uredi spremeniš naslov in dogodke, z Izbriši in potrditvijo Izbrišem webhook? ga odstraniš. Zapis o dostavah ostane shranjen 30 dni.

## Tako preveriš rezultat

Pri ključu je navedeno Nazadnje uporabljeno z datumom, takoj ko ga integracija uporablja. Zahteve 24 h prešteje zahteve.

Pri webhooku Zadnjih 7 dni prikazuje „{Zahl} dostavljeno, {Zahl} neuspešno“, testni dogodek pa je pod Dostave.

## Če kaj ne deluje

„Izberi vsaj eno pravico.“, Nobeno področje nima pravice., Izberi predlogo ali daj vsaj enemu področju Branje ali Pisanje.

„Prosim, vpiši ime.“, Manjka Ime., Vpiši ime.

„Prosim, preveri:“ z naslovom, Naslov v Omejitev IP ni veljaven., Popravi naslov ali omrežje CIDR. Dovoljenih je največ 20 vnosov.

„Izberi datum od jutri, največ tri leta v prihodnosti.“, Datum poteka je zunaj obdobja., Izberi datum od jutri, ki je največ tri leta oddaljen.

„Naslov se mora začeti z https://.“, URL prejemnika ni naslov HTTPS., Vpiši naslov, ki se začne z https://.

„Izberi vsaj en dogodek.“, Webhook nima nobenega dogodka., Pod Dogodki izberi vsaj enega.

Zaustavljen zaradi ponavljajočih se napak, Prejemnik ne odgovori s statusom 2xx., Preveri, ali je prejemnik dosegljiv, in izberi Znova aktiviraj.

„Aktiviraj webhook, da pošlješ testni dogodek.“, Webhook je ustavljen., Aktiviraj Dostava aktivna in pošlji testni dogodek.

„Izbire ni bilo mogoče naložiti. Zapri in ga znova odpri.“, Seznam pravic in dogodkov ni naložen., Zapri pogovorno okno in ga znova odpri.

## To je povezano

Kanali: vrstica API je poleg rezervacijskih portalov: Poveži in spremljaj kanale.

Razvijalski portal: krajišča, kode napak in omejitve zahtev so v razvijalski dokumentaciji.
