search

poff-bnff / web2021

1 stars 0 forks source link

Visitestonia API #509

Open jaanleppik opened 2 years ago

jaanleppik commented 2 years ago

https://www.puhkaeestis.ee/et/turismiprofessionaalile/tootearendus-ja-kvaliteet/visitestonia-api-veebiteenus

Palun uuri seda API juhendit selle pilgiga, et kui me sooviks asukoha põhiselt majutusasutusi visitestonialt pärida. Näiteks teame linna / valda ja ka maakonda, siis

  1. linna / valla järgi
  2. maakonna järgi

Ja kuidas on majutusasutused kirjeldatud - selle pilguga, et kuidas peaksime oma Organisatsiooni collectionit täiendama, et mingi miinimuminfo oleks ka meil salvestatud, koos välise (visitestonia) ID'ga.

PS! kohe peaks saama ka reaalse API ligipääsu.

LiisKasper commented 2 years ago

Hetkel saan aru, et tuleb teha GET päring ja vastuseks saab kindlatele XML Schema'dele vastavad XML dokumendid. Pakutavate teenuste kirjeldused (xsd-d) asuvad leheküljel:  objektide veebiteenuse aadress https://www.visitestonia.com/api/Entries_v4.xsd  domeenide veebiteenuse aadress https://www.visitestonia.com/api/Domains_v2.xsd Sinna pääseb ligi ainult autentides. Visitestonia.com veebiteenuseid tohib välja kutsuda maksimaalselt üks kord iga 5 sekundi järel, ei ole ette nähtud klientprogrammide kasutajate sünkroonseks teenindamiseks. Kõik klientprogrammid peavad eksporditavaid andmeid enda jaoks puhverdama. Päringuid ei tohi teha paralleelselt.

Meta-andmete blokis on järgnev informatsioon:  totalPages – päringu vastuste lehekülgede arv  currentPage – kuvatava lehekülje number  statusText – päringu staatuse inimkeelne selgitus  statusCode – päringu staatuse kood.

Millised kirjed on andemete blokis, dok kirjas pole. Ilmselt vajan ligipääsu.