Mur għall-kontenut
Task, Channels and Partner API

Partner API: Immaniġġja ċ-ċwievet u l-webhooks

Bil-Partner API tqabbad il-paġni tar-riżervi, l-apps u l-integrazzjonijiet tiegħek ma' STRYK. Toħloq ċwievet bid-drittijiet meħtieġa u tissettja webhooks.

Last updated: Owner, Developers
Contents
  1. Qabel tibda
  2. Iftaħ l-API
  3. Oħloq ċavetta tal-API
  4. Immaniġġja ċ-ċwievet
  5. Issettja l-webhooks
  6. Immaniġġja l-webhooks
  7. Kif tiċċekkja r-riżultat
  8. Jekk xi ħaġa ma taħdimx
  9. Dan huwa marbut ma'

Qabel tibda

  • Għandek bżonn id-dritt Immaniġġja l-kanali. Biss b'hekk tara l-linja API fil-paġna Kanali.
  • Iċċara liema oqsma l-integrazzjoni trid taqra jew tikteb. Ċavetta tingħata biss dawk id-drittijiet.
  • Integrazzjoni ssejjaħ il-Partner API mis-server tagħha. Ċ-ċavetta qatt ma titpoġġa fil-kodiċi tal-browser jew f'app. L-endpoints, il-parametri u l-eżempji jinsabu fid-Dokumentazzjoni għall-iżviluppaturi. Hemm it-taqsima Awtentikazzjoni u scopes tispjega x'jippermetti kull dritt.
  • Webhooks jeħtieġu destinatarju b'indirizz li jibda b'https://.

Iftaħ l-API

In STRYKKanali

  1. Agħżel taħt Konnessjonijiet tiegħek il-linja API bl-aġġunta „Ċwievet API u webhooks“. Id-djalogu API jinfetaħ.
  2. Agħżel it-tab Ċwievet API jew Webhooks. B'Dokumentazzjoni għall-iżviluppaturi fil-kap tad-djalogu tiftaħ il-portal tal-iżviluppaturi.
  1. It-tabs Ċwievet API u Webhooks
  2. Ċwievet bid-drittijiet
  3. Azzjonijiet taċ-ċavetta

Oħloq ċavetta tal-API

In STRYKKanaliAPIĊwievet API

  1. Agħżel Oħloq ċavetta tal-API. Id-djalogu Oħloq ċavetta tal-API jinfetaħ.
  2. Daħħal l-Isem, pereżempju „Paġna tar-riżervi“.
  3. Agħżel taħt Drittijiet mudell: Qari biss (jaqra l-oqsma kollha), Qari u kitba (jikteb fejn ikun possibbli) jew Personalizzat. Bi Personalizzat tagħżel għal kull qasam Ebda aċċess, Qari jew Kitba. L-oqsma huma Hotel u kmamar, Disponibbiltà, Prezzijiet u tariffi, Riżerviet, Ospiti, Pagamenti u Fatturi. Kitba tinkludi Qari. Il-fatturi huma dokumenti fiskali tal-otel u jistgħu jinqraw biss permezz tal-API.
  4. Fakultattiv: iftaħ Avvanzat. Agħżel l-Skadenza: Ebda skadenza, 30 jum, 90 jum, 1 sena jew Data (mill-għada, mhux aktar minn tliet snin). Taħt Restrizzjoni tal-IP daħħal f'kull linja indirizz jew netwerk CIDR, sa 20. Vojt jippermetti l-indirizzi kollha. Taħt Nota iżżomm nota interna.
  5. Agħżel Oħloq. STRYK juri Ċavetta tal-API maħluqa maċ-ċavetta u n-nota Jidher biss issa.
  6. Ikkopja ċ-ċavetta u aħżinha pereżempju f'manager tal-password. Agħżel Lest.

Immaniġġja ċ-ċwievet

In STRYKKanaliAPIĊwievet API

Il-lista turi għal kull ċavetta l-Isem, il-bidu taċ-ċavetta, id-Drittijiet, Maħluqa, L-aħħar użat, Skadenza u l-istatus: Attiv, Se jiskadi dalwaqt, Revokat jew Skadut. Agħżel ċavetta biex tara d-Drittijiet, is-Skadenza, l-Indirizzi tal-IP permessi, il-Limitu tat-talbiet (talbiet kull minuta), l-Użu, l-L-aħħar talbiet u l-Storja.

  1. Fil-linja iftaħ il-menu Għażliet.
  2. Agħżel Ġenera mill-ġdid jekk l-integrazzjoni għandha tirċievi ċavetta ġdida bl-istess drittijiet. Taħt Iċ-ċavetta attwali agħżel Iċ-ċavetta l-qadima għadha valida għal 24 h, biex tkun tista' tibdel l-integrazzjoni, jew Revoka minnufih. Ikkonferma b'Ġenera mill-ġdid. STRYK juri ċ-ċavetta l-ġdida darba.
  3. Agħżel Revoka u kkonferma Tirrevoka ċ-ċavetta tal-API? biex tblokka ċavetta minnufih. STRYK imbagħad jirrifjuta t-talbiet b'din iċ-ċavetta.

Issettja l-webhooks

In STRYKKanaliAPIWebhooks

Webhook jibgħat l-avvenimenti magħżula, iffirmati, permezz ta' HTTPS lis-sistemi tiegħek.

  1. Agħżel Oħloq webhook. Id-djalogu Webhook ġdid jinfetaħ.
  2. Daħħal l-URL tad-destinazzjoni, pereżempju https://crm.nordlicht.invalid/hooks/stryk. L-indirizz irid jibda b'https://.
  3. Fakultattiv: daħħal Deskrizzjoni, pereżempju „Riżerviet lis-CRM tagħna“.
  4. Agħżel taħt Avvenimenti mill-inqas wieħed: Riżerva maħluqa, Riżerva aġġornata, Riżerva ikkanċellata, Ospite mibdul, Id-disponibbiltà nbidlet, Il-prezz inbidel, Pagament mibdul jew Status tal-kamra mibdul. B'Agħżel kollox u Neħħi l-għażla tagħżel kollox jew xejn.
  5. Agħżel Oħloq webhook. STRYK juri Is-sigriet tal-iffirmar tiegħek darba.
  6. Ħalli s-sigriet fid-destinatarju tiegħek. Kif id-destinatarju jivverifika l-iffirmar tiegħu, jiddeskrivih id-dokumentazzjoni għall-iżviluppaturi taħt Webhooks u verifika tal-iffirmar.
  7. Agħżel il-webhook u mbagħad Ibgħat avveniment ta' prova. STRYK jgħid „Avveniment ta' prova qed jiġi kkunsinnat.“

Immaniġġja l-webhooks

Ort: Kanali > API > Webhooks, agħżel webhook

  • B'il-kmuta Kunsinna attiva tpawża jew tattiva l-webhook. Webhooks mpawżin ma jirċevux avvenimenti. Wara l-attivazzjoni l-kunsinna tibda b'avvenimenti ġodda.
  • L-aħħar 7 ijiem, L-aħħar suċċess u L-aħħar żball juru l-istat. Taħt Kunsinni tara kull kunsinna b'Status tal-HTTP u Tentattivi. B'Ibgħat mill-ġdid tirrepeti kunsinna.
  • Ibdel is-sigriet joħloq sigriet ġdid. Dak preċedenti jibqa' validu għal 24 siegħa, biex tkun tista' tibdel id-destinatarju.
  • B'Editja tibdel l-indirizz u l-avvenimenti, b'Ħassar u l-konferma Thassar il-webhook? titneħħa. Ir-reġistru tal-kunsinni jibqa' 30 jum.

Kif tiċċekkja r-riżultat

  • Taċ-ċavetta jidher L-aħħar użat bid-data, hekk kif l-integrazzjoni tużaha. Talbiet 24 h jgħodd it-talbiet.
  • Fuq il-webhook L-aħħar 7 ijiem juri „{Zahl} kkunsinnati, {Zahl} falliti“, u l-avveniment ta' prova jidher taħt Kunsinni.

Jekk xi ħaġa ma taħdimx

Dak li taraKawżaKif issolvih
„Agħżel mill-inqas dritt wieħed.“Ebda qasam m'għandu dritt.Agħżel mudell jew agħti mill-inqas lil qasam wieħed Qari jew Kitba.
„Daħħal isem.“L-Isem huwa nieqes.Daħħal isem.
„Iċċekkja:“ segwit mill-indirizz.Indirizz taħt Restrizzjoni tal-IP mhux validu.Ikkoreġi l-indirizz jew in-netwerk CIDR. Jiġu permessi sa 20 dħul.
„Agħżel data mill-għada, mhux aktar minn tliet snin ’il quddiem.“Id-data tal-iskadenza tinsab barra mill-perjodu.Agħżel data mill-għada li mhix aktar minn tliet snin ’il bogħod.
„L-indirizz irid jibda b'https://.“L-URL tad-destinazzjoni mhix indirizz HTTPS.Daħħal indirizz b'https://.
„Agħżel mill-inqas avveniment wieħed.“Il-webhook m'għandu ebda avveniment.Agħżel mill-inqas wieħed taħt Avvenimenti.
Sospiż minħabba żbalji ripetutiId-destinatarju ma jwieġibx b'status 2xx.Iċċekkja jekk id-destinatarju jkunx jista' jintlaħaq, u agħżel Erġa' attiva.
„Attiva l-webhook biex tibgħat avveniment ta' prova.“Il-webhook huwa mpawża.Attiva Kunsinna attiva u ibgħat l-avveniment ta' prova.
„L-għażla ma setgħetx titgħabba. Agħlaq u erġa' iftaħ.“Il-lista tad-drittijiet u l-avvenimenti ma tgħabbatx.Agħlaq id-djalogu u erġa' iftaħlu.
Kuntatt