API ili iCal: što se prenosi između kalendara?

Što zapravo sadrži iCal

RFC 5545 definira iCalendar kao format kalendarskih informacija, uključujući događaje. Datumi početka i završetka te identifikator događaja primjeri su njegovih elemenata. Standard opisuje format; ne propisuje koliko često pojedini portal preuzima tuđi kalendar.

U povezivanju smještaja iCal se često koristi za zauzete termine. Airbnb, primjerice, opisuje izvoz poveznice kalendara i uvoz poveznice drugog servisa. Koje se blokade prenose i kako ih drugi sustav prikazuje provjerite prema uputama oba servisa.

Nemojte iz kalendarskog događaja zaključiti da su preneseni cjenik, uvjeti prodaje ili kompletna rezervacija. Za takav zahtjev tražite izričitu dokumentaciju, umjesto da se oslonite na oznaku sinkronizacije.

Dvije promjene koje pokazuju razliku

Primjer zauzeća: blokirate pet noći u kalendaru A. Kalendar B tu blokadu vidi tek kada preuzme promjenu prema svojim pravilima. Poveznica A → B ne uspostavlja automatski i smjer B → A.

Primjer cijene: vikend povećate sa 100 na 120 € i postavite minimalno tri noći. Kalendar zauzetosti ne prenosi taj cjenik. Za centralno slanje potrebna je integracija koja podržava baš cijenu i to ograničenje na odabranom kanalu.

Praktičan izbor: iCal može poslužiti za pregled blokiranih datuma. Ako želite centralno upravljati prodajnim uvjetima ili preostalim brojem soba, tražite dokumentiranu funkciju API veze. Sam naziv API nije dokaz da će dobavljač poslati svaki podatak.

Zašto API veza može obuhvatiti više podataka

API određuje dopuštene operacije i podatke koje sustav prima ili vraća. Booking.com objavljuje Rates & Availability API za inventar, cijene i restrikcije te zaseban Reservations API za rezervacije i njihove promjene.

ARI je kratica za availability, rates and inventory: raspoloživost, cijene i inventar. To opisuje područje razmjene; nije potvrda da određeni proizvod podržava sve cjenike, pravila ili kanale.

S dobavljačem odvojeno provjerite slanje i primitak svake vrste podatka. Pristup jednom sučelju ne znači automatski pristup drugim funkcijama. Javna dokumentacija portala nije potvrda mogućnosti vašeg ugovorenog paketa.

Razlike koje utječu na svakodnevni rad

Kašnjenje procjenjujte prema načinu prodaje

Airbnbove upute navode periodično osvježavanje uvezenih kalendara te ručno osvježavanje uz ograničenja. Iz tog primjera ne slijedi jednak interval drugih servisa. Aktualna pravila pročitajte na poveznici izvora prije postavljanja.

Za vlastitu odluku zapišite koliko dugo možete prihvatiti nesklad između dva prikaza. Ako se ista zadnja jedinica može odmah rezervirati na više portala, provjerite cijeli postupak usklađivanja i postupak za odstupanje.

Brzinu konkretne integracije treba izmjeriti u dogovorenoj provjeri. Ovdje ne navodimo univerzalnu brzinu niti jamčimo da iCal ili API onemogućuju svaku dvostruku rezervaciju.

Kada iCal može biti dovoljno jednostavno rješenje

Razmotrite iCal ako trebate prvenstveno prenijeti zauzete datume, prihvaćate pravila osvježavanja oba servisa i spremni ste ostale podatke uređivati odvojeno. To je kriterij za vlastitu procjenu, ne preporuka određene marke.

Ilustrativni primjer: vlasnik želi osobni pregled zauzetosti, a cijene uređuje na prodajnom portalu. Kalendarski uvoz može odgovarati toj ograničenoj potrebi ako prenosi potrebne datume. Prije oslanjanja na njega provjerite izmjenu i otkazivanje.

Ako zahtijevate centralne promjene cijena, zajednički kapacitet više soba ili određene restrikcije, ne zaključujte da će kalendar zadovoljiti zahtjev. Zatražite prikaz funkcija koje trebate i usporedite ga s API ponudom.

Mali plan provjere prije oslanjanja na vezu

Ovo je prijedlog za demonstraciju s dobavljačem, ne izvještaj o provedenom testiranju. Koristite dogovoreni testni objekt ili siguran postupak koji ne stvara stvarne rezervacije.

1. Zapišite sustav A, sustav B, jedinicu i podatak koji želite prenijeti.
2. Dogovorite početno stanje i rezultat za novu zauzetost.
3. Provjerite promjenu datuma i otkazivanje, uključujući ponovno otvaranje termina.
4. Za API ponudu zasebno demonstrirajte cijenu i potrebne restrikcije.
5. Zabilježite vrijeme, status i mjesto za prijavu nesklada.
6. Odredite tko prati greške i kako prekinuti vezu bez gubitka pregleda rezervacija.

Povežite tehnički zahtjev s ponudom

Najprije potvrdite što veza radi, zatim zatražite cijenu za taj opseg. Kalkulator troška u povezanim temama zbraja vaše iznose; ne pretpostavlja da je bilo koja tehnologija besplatna ili skuplja.

Za širi kontekst inventara, PMS-a i rezervacija otvorite osnovni vodič. Pravila o izvorima i povezanosti s dobavljačima nalaze se u metodologiji i na stranici O projektu.