Elektronski naslov
Geslo
 
Ste pozabili geslo? ?
Elektronski naslov
Izkoristite priložnost za veliki popust do 30%
Zasebna namestitev charter

API dokumentacija

Trenutno ste na: Partnerji > Affiliate program > XML servis > API dokumentacija

Version 1.2

About

Adriatic.hr Web Service is a web API [?], based on REST [?], which allows communication between yours and Adriatic.hr web site. Thanks to it, visitors of your web site can search, preview and place order for any service in our offering, without leaving your web site.

It can be used by calling the access URL - https://www.adriatic.hr/services/rest/. Actually, this URL is only an endpoint and you need to provide some additional information in the form of GET/POST parameters. Every call to the specified URL should be accompanied with at least two special parameters - method name and application ID - but actual number of parameters depends of method. Here is the list of all special parameters:

  • method - web service (method) name (required)
  • aid - application ID; this is your unique ID information which will be generated for you after opting for our web services (required)
  • lang - two-letter language code (according to ISO 639-1 standard) in lowercase, used to localize results (if needed); defaults to en - english. (not required)
  • sig - request signature. Composed of name of the method that is called, application ID and (encrypted) unique private key. Used ONLY in combination with SSL[?] (Secure Sockets Layer) protocol to secure the communication. (required from 01.01.2011)
    • sig generation: md5("method_called;aid;md5(private_key)")
    • example: md5("Private_getHouse;af151;md5(private_key)")
    • usage: https://www.adriatic.hr/services/rest/?
      method=Private_getHouse&id=1005&aid=
      af151&lang=en&sig=6f0dcac4960e0eab40c4bdc1d42b6c03
Methods of our web service are divided into the following groups (namespaces):
  • Private accommodation - namespace Private
  • Geography locations - namespace Geo
  • Ordering process - namespace Order
  • System/helper/common - namespace System

Usage

The following example retrieves data of private accommodation house with ID 1005. Click on preview link to see the service result. https://www.adriatic.hr/services/rest/
  ?method=Private_getHouse
  &id=1005
  &aid=af151
  &lang=sl
  &sig=6f0dcac4960e0eab40c4bdc1d42b6c03


Each parameter is specified inside URL as name=value pair. The method parameter specifies service method to be invoked. All subsequent parameters are parameters passed to specified method. Some method parameters are optional while others are required to be set - faling to specifiy the required parameter will result in error.

Methods

Here is the list of supported service methods. Request parameters written in bold are required.

Many response elements contain special boolean attribute na. It stands for "not available" and means that element value is unknown (null). This attribute exist only for elements which value can be unknown.

Possible response statuses are success and failure.

Private_find

Search private accommodation. Method is pagination aware (results are split across multiple pages).

Request parameters

i_fromdateBegin of interval. Allowed formats are YYYY-MM-DD and unix timestamp.
i_todateEnd of interval. Allowed formats are YYYY-MM-DD and unix timestamp.
i_devboolAllow slight shifting of given date interval to find more accommodation units. Default value is TRUE.
i_subboolLook for subinterval of given interval, instead of just given interval. Subinterval is limited by len_min and len_max parameters. If interval is not set, main season is used (june, july and august). This parameter is handy if you want to find units available, e.g., in main season (when most of them are not available). Default value is FALSE.
len_minintMinimum number of nights. Used only if i_sub is true. Default value is 1.
len_maxintMaximum number of nights. Used only if i_sub is true. Default value is 6.
ttypeComma delimited list of accommodation unit types. Example: "apartment,room". Supported types are:
  • house
  • apartment
  • studio-apartment
  • room
idintComma delimited list of house IDs. Example: "1005,1006". Use case example - if you want to get a price range of desired house(s).
kit_roomboolUse of the kitchen for unit type room.
pintNumber of persons.
p_distboolAllow to split persons in more than one accommodation unit inside house. Default value is FALSE.
cattypeHouse category. Supported types are:
  • luxury
  • pool
  • house
  • pension
  • family_owned_hotel
  • beach
  • quiet
  • robinson
Supports multiple values separated by ',' (AND operator) or '|' (OR operator).
pos_flintFloor. Value of zero represent ground floor, negative values represent basement floors. Supports multiple values separated by '|' (OR operator).
prc_minfloatMinimal price in EUR (per day). Default value is 0.
prc_maxfloatMaximal price in EUR (per day).
prc_lowboolLow-price accommodation.
prc_wodboolRetrieve prices without discounts (applies only to an accommodation service price list). Use this if you want to show original prices (without discount, if any exist) and print (advert) discount information elsewhere, instead of just including discounts into prices. Default value is FALSE.
dcboolDiscount accommodation (any type of discount).
dc_ttypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
dc_gboolSpecial discount accommodation (specific type of discount). This element is deprecated. See dc_t.
dc_mwboolMost wanted accommodation. This element is deprecated, see dc_t. This element is deprecated. See dc_t.
qstringKeywords for textual search (geography location names only).
lstringGeography location ID.
pl_isolboolPlace in isolation.
ri_ttypeRiviera type. Supported types are:
  • mainland
  • mainland_river
  • island
  • islands
  • island_bridge
  • peninsula
Supports multiple values separated by '|' (OR operator).
be_ttypeBeach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva
Supports multiple values separated by '|' (OR operator).
be_dintMaximal house to beach distance.
poolboolHouse with pool.
acboolAccommodation unit with air conditioner.
stvboolAccommodation unit with satellite TV.
foodboolHouse with food service.
petboolHouse with pet approval.
boatboolHouse with boat rent service.
moorboolHouse with boat moor.
outer_view_seaboolHouse with sea view.
outer_grillboolHouse with outer grill.
inetboolHouse with internet.
disboolUnit access suitable for disabled persons.
bedroomsintNumber of bedrooms. It can be used in combination with p_dist param.
sorttypeSort criterion. Supported types are:
  • standard
  • price
  • beach
  • centre
Default value is standard.
sort_dirtypeSort direction. Supported types are:
  • asc - Ascending
  • desc - Descending
Default value is asc.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
housesetFound house. See <house> (House data) for details. Element has the following attributes:
  • id [int]: House ID.
unitsarrayAccommodation units which belongs to house from the same <item> element. Only units that match search criteria are enlisted here. Array of <unit> elements. See <unit> (Accommodation unit data) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.
<house> - House data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: House ID.
namestringHouse name.
capacityintNumber of beds.
foodboolFood service available?
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
directBookingboolAvailability status is accurate - order is possible without agency confirmation?
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria). Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
geosetGeography location. See <geo> (Geography location data) for details.
distancesetDistances. See <distance> (Distance data) for details.
categoriesarrayCategories which house belongs to. Array of <category> elements. See <category> (House category data) for details.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit (see Private_getUnit response), whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
relatesetRelated houses. See <relate> (Related objects) for details.
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
redirectarrayRedirect links [URL]. Array of <redirect> elements. See <redirect> (Redirect links [URL]) for details.
imagearrayImage of house. Array of <variant> elements. See <variant> (Image variant data) for details.
<unit> - Accommodation unit data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Accommodation unit ID.
namestringName.
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
typetypeType. Supported types are:
  • house
  • apartment
  • studio-apartment
  • room
labelstringAccommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
capacitysetCapacity data. See <capacity> (Capacity data) for details.
classsetClassification data. See <class> (Accommodation unit classification data) for details.
priceRangearrayAccommodation unit price range. Contains two amounts (range), single amount (exact price is known) or no amounts (price is unknown). Value depends on search parameters used (date interval and number of persons). Array of <amount> elements. See <amount> (Price amount (per day).) for details.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit, whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
lowPriceboolAccommodation unit has a low price?
redirectarrayRedirect links [URL]. Array of <redirect> elements. See <redirect> (Redirect links [URL]) for details.
imagearrayImage of house. Array of <variant> elements. See <variant> (Image variant data) for details.
<unit> - Accommodation unit reference data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
  • capacityBasic [int]: Basic capacity of the accommodation unit.
  • capacityAdditional [int]: Additional capacity of the accommodation unit.
<geo> - Geography location data
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
placestringPlace name. Element has the following attributes:
  • id [string]: Place ID.
  • isletName [string]: Islet name, if set, the place is located on a islet.
beachnullBeach placeholder - beaches does not have names, only IDs. Element has the following attributes:
  • id [string]: Beach ID.
<distance> - Distance data
beachintDistance from beach (meters).
<category> - House category data
selftypeHouse category. Supported types are:
  • luxury
  • pool
  • house
  • pension
  • family_owned_hotel
  • beach
  • quiet
  • robinson
<discount> - Discount/additional payment data
typetypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
namestringName.
valuesetPercent, money or freeDays value. See <value> (Discount/additional payment value) for details.
<relate> - Related objects
existboolIs object related with any other object?
housesarrayOther houses that are related to this house. Array of <house> elements. See <house> (Related House element) for details.
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large
    • s - small
    • m - medium
urlstringImage variant URL.
<rating> - Ratings (1-5)
placeintAverage place rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
beachintAverage beach rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
accomodationintAverage accomodation rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
hostintAverage host rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
totalintTotal average rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
<redirect> - Redirect links [URL]
URL links for redirection.
housestringHouse URL.
unitstringUnit URL.
orderstringOrdering URL.
<capacity> - Capacity data
totalintTotal number of beds.
basicintNumber of basic (main) beds.
additionalintNumber of additional beds.
<class> - Accommodation unit classification data
official intOfficial classification mark (by Croatian authority).
adriaticfloatAdriatic.hr classification mark.
<amount> - Price amount (per day).
selffloatPrice amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
<value> - Discount/additional payment value
Percent, money or freeDays amount. Negative values are discounts, positive values are additional payments.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Value type. Supported types are:
    • percent
    • amount
    • extra_day
percentfloatPercent value.
amountfloatMoney amount value. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
freeDaysintNumber of free days. Element has the following attributes:
  • total [int]: Total number of days.
<house> - Related House element
namestringHouse name
capacityintNumber of beds
sameBuildingboolThis house belong to the same building.

Example usage

Find apartments available in date interval 2012-08-09 to 2012-08-15.

https://www.adriatic.hr/services/rest/
  ?method=Private_find
  &i_from=2012-08-09
  &i_to=2012-08-15
  &t=apartment
  &aid=af151
  &lang=sl
  &sig=e449a43f7f2c6ac9e4af475d0607c5c1

Private_findReviews

Search guest comments for objects. Method is pagination aware (results are split across multiple pages).

Request parameters

idintObject ID. This parameter is required.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
unitstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
idintReview id.
authorstringReview author name.
createddatetimeReview creation time. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
customerboolAdriatic.hr customer.
reviewstringReview text. Element has the following attributes:
  • deleted [bool]: Has the review been deleted due to inappropriate contents?
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.
<rating> - Ratings (1-5)
placeintPlace rating.
beachintBeach rating.
accomodationintAccomodation rating.
hostintHost rating.

Example usage

Find reviews for object with ID 1005.

https://www.adriatic.hr/services/rest/
  ?method=Private_findReviews
  &id=1005
  &aid=af151
  &lang=sl
  &sig=d5f34cd9084c08130929e02b57b0630f

Private_getHouse

Retrieve house data.

Request parameters

idintHouse ID. This parameter is required.

Response

<house> - House data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: House ID.
namestringHouse name.
capacityintNumber of beds.
publishDatedateHouse publish date. Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
postalCodestringPostal code.
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
directBookingboolAvailability status is accurate - order is possible without agency confirmation?
unitsarrayReferences to all accommodation units which belongs to this house (not necessary match search criteria). Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
geosetGeography location. See <geo> (Geography location data) for details.
exteriorsetHouse exterior. See <exterior> (Exterior data) for details.
servicesetAvailability and details of services. See <service> (Service data) for details.
distancesetDistances. See <distance> (Distance data) for details.
locationsetLocation data. See <location> (Location data) for details.
communicationsetPossibilities of communication inside house. See <communication> (Communication data) for details.
categoriesarrayCategories which house belongs to. Array of <category> elements. See <category> (House category data) for details.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit (see Private_getUnit response), whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
lowPriceboolHouse contains at least one unit that has a low price?
relatesetRelated houses. See <relate> (Related objects) for details.
notesarrayAdditional house characteristics. Array of <note> elements. See <note> (Additional house characteristic) for details.
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
redirectarrayRedirect links [URL]. Array of <redirect> elements. See <redirect> (Redirect links [URL]) for details.
imagesarrayHouse images. Array of <image> elements. See <image> (House image) for details.
descriptionsetObject description. See <description> (Object description) for details.
<unit> - Accommodation unit reference data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
  • capacityBasic [int]: Basic capacity of the accommodation unit.
  • capacityAdditional [int]: Additional capacity of the accommodation unit.
<geo> - Geography location data
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
placestringPlace name. Element has the following attributes:
  • id [string]: Place ID.
beachnullBeach placeholder - beaches does not have names, only IDs. Element has the following attributes:
  • id [string]: Beach ID.
<exterior> - Exterior data
disabledPersonsboolIs suitable for disabled persons?
courtyardsetExistence and description of courtyard. See <courtyard> (Courtyard data) for details.
poolsetAvailability and terms of pool usage. See <pool> (Pool data) for details.
garagesetAvailability and terms of garage usage. See <garage> (Garage data) for details.
parkingsetAvailability and terms of parking usage. See <parking> (Parking data) for details.
grillsetAvailability and location of grill. See <grill> (Grill data) for details.
showerboolHas shower in the courtyard?
<service> - Service data
checkinsetCheckin service data. See <checkin> (Checkin service data) for details.
ecoTaxsetEcological taxation service data. See <ecoTax> (Ecological taxation service data) for details.
insurancesetMandatory insurance service data. See <insurance> (Mandatory insurance service data) for details.
phonesetPhone usage data. See <phone> (Phone service data) for details.
faxsetFax usage data. See <fax> (Fax service data) for details.
internetsetInternet access usage data. See <internet> (Internet access service data) for details.
foodsetFood service data. See <food> (Food service data) for details.
laundrysetLaundry service data. See <laundry> (Laundry service data) for details.
boatsetBoat usage data. See <boat> (Boat service data) for details.
moorsetMoor usage data. See <moor> (Moor service data) for details.
petsetUnit with pet approval. See <pet> (Pet service data) for details.
<distance> - Distance data
seaintDistance from sea (meters).
beachintDistance from beach (meters).
shopintDistance from shop (meters). Element has the following attributes:
  • inHouse [bool]: Shop is located in the facility?
restaurantintDistance from restaurant (meters). Element has the following attributes:
  • inHouse [bool]: Restaurant is located in the facility?
ambulanceintDistance from ambulance (meters). Element has the following attributes:
  • inHouse [bool]: Ambulance is located in the facility?
postOfficeintDistance from post office (meters). Element has the following attributes:
  • inHouse [bool]: Post office is located in the facility?
discointDistance from disco (meters). Element has the following attributes:
  • inHouse [bool]: Disco is located in the facility?
hotelPoolintDistance from hotel pool (meters). Element has the following attributes:
  • inHouse [bool]: Hotel pool is located in the facility?
sportsGroundintDistance from sports ground (meters). Element has the following attributes:
  • inHouse [bool]: Sports ground is located in the facility?
divingintDistance from diving center (meters). Element has the following attributes:
  • inHouse [bool]: Diving center is located in the facility?
pharmacyintDistance from pharmacy (meters). Element has the following attributes:
  • inHouse [bool]: Pharmacy is located in the facility?
atmintDistance from atm (meters). Element has the following attributes:
  • inHouse [bool]: Atm is located in the facility?
internetCaffeintDistance from internet caffe (meters). Element has the following attributes:
  • inHouse [bool]: Internet caffe is located in the facility?
exchangeOfficeintDistance from exchange office (meters). Element has the following attributes:
  • inHouse [bool]: Exchange office is located in the facility?
touristInfointDistance from tourist info (meters). Element has the following attributes:
  • inHouse [bool]: Tourist info is located in the facility?
infirmaryintDistance from infirmary (meters). Element has the following attributes:
  • inHouse [bool]: Infirmary is located in the facility?
airportintDistance from airport (meters). Element has the following attributes:
  • inHouse [bool]: Airport is located in the facility?
autocampintDistance from autocamp (meters). Element has the following attributes:
  • inHouse [bool]: Autocamp is located in the facility?
golfCourseintDistance from golf course (meters). Element has the following attributes:
  • inHouse [bool]: Golf course is located in the facility?
tennisCourtintDistance from tennis court (meters). Element has the following attributes:
  • inHouse [bool]: Tennis court is located in the facility?
playgroundintDistance from playground (meters). Element has the following attributes:
  • inHouse [bool]: Playground is located in the facility?
centreintDistance from place center (meters).
<location> - Location data
nearMainRoadboolIs near main road?
beachAcrossRoadboolIs there a road between house and beach?
nearBeachboolIs near beach?
stairsToBeachintNumber of stairs between house and beach.
reachableByCarboolIs object reachable by car.
parkDistanceintDistance from nearest parking place (meters).
securedParkingboolIs parking place secured?
stairsToParkingintNumber of stairs between house and nearest parking place.
quietboolSurrounding is quiet?
isolationboolHouse is isolated?
greenboolSurrounding is green?
<communication> - Communication data
hostPresentboolIs host presence possible?
otherGuestsboolIs other guests presence possible (in accommodation units outside of our offering)?
hostLanguagesarrayForeign languages which the host is familiar with. Array of <language> elements. See <language> (Host foreign language data) for details.
<category> - House category data
selftypeHouse category. Supported types are:
  • luxury
  • pool
  • house
  • pension
  • family_owned_hotel
  • beach
  • quiet
  • robinson
<discount> - Discount/additional payment data
typetypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
namestringName.
valuesetPercent, money or freeDays value. See <value> (Discount/additional payment value) for details.
<relate> - Related objects
existboolIs object related with any other object?
housesarrayOther houses that are related to this house. Array of <house> elements. See <house> (Related House element) for details.
<note> - Additional house characteristic
selfstringDescription.
<rating> - Ratings (1-5)
placeintAverage place rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
beachintAverage beach rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
accomodationintAverage accomodation rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
hostintAverage host rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
totalintTotal average rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
<redirect> - Redirect links [URL]
URL links for redirection.
housestringHouse URL.
unitstringUnit URL.
orderstringOrdering URL.
<image> - House image
selfarrayImage variants. Array of <variant> elements. See <variant> (Image variant data) for details. Element has the following attributes:
  • type [type]: Image type (based on subject). Supported types are:
    • exterior
    • courtyard
    • parking
    • host
<courtyard> - Courtyard data
existboolCourtyard exists?
sizeboolCourtyard size (in square meters).
playgroundboolHas children playground?
seatsboolHas seating place?
<pool> - Pool data
existboolPool exists?
pricesetPricing data. See <price> (Pricing data) for details.
<garage> - Garage data
existboolGarage exists?
pricesetPricing data. See <price> (Pricing data) for details.
placesintNumber of places.
<parking> - Parking data
existboolParking exists?
pricesetPricing data. See <price> (Pricing data) for details.
placesintNumber of places.
<grill> - Grill data
existboolGrill exists?
locationtypeGrill location. Supported types are:
  • terrace
  • courtyard
<checkin> - Checkin service data
existboolCheckin service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<ecoTax> - Ecological taxation service data
existboolEcological taxation service exists?
pricesetPricing data. See <price> (Pricing data) for details.
freeAgeLt12boolIs ecotax free for children with age under 12 years?
<insurance> - Mandatory insurance service data
existboolMandatory insurance service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<phone> - Phone service data
existboolPhone service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
<fax> - Fax service data
existboolFax service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
<internet> - Internet access service data
existboolInternet access service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
typetypeInternet access type. Supported types are:
  • adsl
  • isdn
  • 56k
  • 3G
ratesetInternet access rate. See <rate> (Internet access rate data) for details. This element is deprecated. See <type>.
hostComputerboolPossible access via house host computer?
guestComputerboolPossible access via guest computer?
guestConnTypetypeGuest computer connection type. Supported types are:
  • wifi - WLAN adapter required
  • ethernet - ethernet port required
  • usb - USB port required
  • isdn - ISDN adapter required
  • analogue - analogue modem required
locationSharedboolIs internet access available in the joint room?
<food> - Food service data
breakfastsetBreakfast service data. See <breakfast> (Breakfast service data) for details.
halfboardsetHalf-board service data. See <halfboard> (Half-board service data) for details.
fullboardsetFull-board service data. See <fullboard> ( Full-board service data) for details.
forcedtypeRequired food service type. Empty value means none. Supported types are:
  • breakfast
  • halfboard
  • fullboard
freeAgeLt4boolIs food service free for children with age under 4 years?
halfAge4To12boolIs food service on 50% discount for children with age of 4 to 12 years?
<laundry> - Laundry service data
existboolLaundry service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
locationHostboolIs washing machine at the owner's apartment?
locationSharedboolIs washing machine in the joint room?
<boat> - Boat service data
existboolBoat service exists?
onRequestboolService available on request?
pricesetPricing data. See <price> (Pricing data) for details.
fuelIncludedboolIs fuel included?
<moor> - Moor service data
existboolMoor service exists?
onRequestboolService available on request?
pricesetPricing data. See <price> (Pricing data) for details.
<pet> - Pet service data
existboolPet service exists?
pricesetPricing data. See <price> (Pricing data) for details.
onRequestboolService available on request?
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large
    • s - small
    • m - medium
urlstringImage variant URL.
<price> - Pricing data
typetypePrice type. Supported types are:
  • extra - service is charged additionaly
  • extra_adult - service is charged additionaly only for adults
  • included - service is not charged additionaly
  • agreement - service price is subject of agreement with house owner
amountfloatPrice amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
unittypePrice unit type. Supported types are:
  • onetime
  • day
  • person
  • person_day
  • hour
  • minute
  • second
  • page
  • kb
  • mb
  • gb
  • wash
  • call
<value> - Discount/additional payment value
Percent, money or freeDays amount. Negative values are discounts, positive values are additional payments.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Value type. Supported types are:
    • percent
    • amount
    • extra_day
percentfloatPercent value.
amountfloatMoney amount value. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
freeDaysintNumber of free days. Element has the following attributes:
  • total [int]: Total number of days.
<rate> - Internet access rate data
dlintDownload rate. Element has the following attributes:
  • unit [type]: Rate unit. Sole supported type is:
    • kbps
ulintUpload rate. Element has the following attributes:
  • unit [type]: Rate unit. Sole supported type is:
    • kbps
<language> - Host foreign language data
codestringTwo-letter language code (according to ISO 639-1 standard) in lowercase.
knowledgeintKnowledge mark. Range is from 1 (poor) to 5 (excellent).
<breakfast> - Breakfast service data
existboolBreakfast service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<halfboard> - Half-board service data
existboolHalf-board service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<fullboard> - Full-board service data
existbool Full-board service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<house> - Related House element
namestringHouse name
capacityintNumber of beds
sameBuildingboolThis house belong to the same building.
<description> - Object description
summarystringObject description summary
bodystringObject description body

Example usage

Retrieve data of private accommodation house with ID 1005.

https://www.adriatic.hr/services/rest/
  ?method=Private_getHouse
  &id=1005
  &aid=af151
  &lang=sl
  &sig=6f0dcac4960e0eab40c4bdc1d42b6c03

Private_getUnit

Retrieve accommodation unit data.

Request parameters

idintAccommodation unit ID. This parameter is required.
prc_wodboolPrices without discounts (applies only to an accommodation service price list). Use this if you want to show original price list (without discount, if any exist) and print (advert) discount information elsewhere, instead of just including discounts into price list. Default value is FALSE.

Response

<unit> - Accommodation unit data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Accommodation unit ID.
namestringName (eg. A-1000-c, K-1000, etc.). Name is consisted of type code (K, A, AS or K), house name and character label (not used for house type). This description is for your information only (you don't have to deal with it).
lastIntervalCheckdatetimeTime when availability intervals are last updated. Date-time string in YYYY-MM-DD hh:mm:ss format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
typetypeType. Supported types are:
  • house
  • apartment
  • studio-apartment
  • room
labelstringCharacter label. Used to distinguish multiple accommodation units with a same type, within the same house.
housestringName of the house which accommodation unit belongs to. Element has the following attributes:
  • id [int]: House ID.
capacitysetCapacity data. See <capacity> (Capacity data) for details.
classsetClassification data. See <class> (Accommodation unit classification data) for details.
positionsetPosition inside house data. See <position> (Position data) for details.
entrancesetEntrance data. See <entrance> (Entrance data) for details.
disabledPersonsboolIs suitable for disabled persons?
partsarrayAvailable parts. Part is an inner or outer area of accommodation unit (eg. room, terrace, balcony, etc.). Array of <part> elements. See <part> (Part data) for details.
servicesetAvailability and details of services. See <service> (Service data) for details.
priceListsetPrice list data. Accommodation unit daily price depends of date and number of persons. Thus, prices are groupped by date intervals and number of persons. See <priceList> (Price list data) for details.
redirectarrayRedirect links [URL]. Array of <redirect> elements. See <redirect> (Redirect links [URL]) for details.
ratingsetRatings. See <rating> (Ratings (1-5)) for details.
imagesarrayImages. Array of <image> elements. See <image> (Image) for details.
<capacity> - Capacity data
totalintTotal number of beds.
basicintNumber of basic (main) beds.
additionalintNumber of additional beds.
<class> - Accommodation unit classification data
official intOfficial classification mark (by Croatian authority).
adriaticfloatAdriatic.hr classification mark.
<position> - Position data
floorintFloor. Value of zero represent ground floor, negative values represent basement floors.
floorSpanintNumber of floors through which this accommodation unit spans.
halfBasementboolIs this a half basement floor? This value makes sense only if floor has value of -1. This element is deprecated. See <raisedFloor>.
raisedFloorboolIs the unit floor raised? Special examples: if floor is 0 (ground floor) and the floor is raised, it's upper ground floor; if floor is -1 (basement) and the floor is raised, it's half basement.
mezzanineboolIs this a mezzanine floor?
multilevelboolDoes this unit have different levels on the same floor (stairs or ramps)?
<entrance> - Entrance data
sharesetEntrance sharing data. See <share> (Resource sharing data) for details.
<part> - Part data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Part ID.
typetypeType. Supported types are:
  • living
  • dining
  • kitchen
  • bathroom
  • toilet
  • bedroom
  • hall
  • terrace
  • balcony
sizeintSize (in square meters).
houseboolBelongs to the entire house?
bedsarrayAvailable beds. Array of <bed> elements. See <bed> (Bed data) for details.
standardboolHas standard equipment? Used for kitchens only. Standard equipment includes: refrigerator, stove (without oven) and dishes
ovenboolHas oven? Used for kitchens only.
iceChestboolHas ice-chest? Used for kitchens only.
fridgeIceChestboolHas combine fridge/ice-chest? Used for kitchens only.
dishWasherboolHas dish-washer? Used for kitchens only.
bathTubboolHas bathtub? Used for bathrooms only.
showerBathboolHas shower-bath? Used for bathrooms only.
shadesetSun shade data. Used for outer parts (terraces and balconies) only. See <shade> (Sun shade data) for details.
seaViewboolHas sea view? Used for outer parts (terraces and balconies) only.
grillsetGrill data. Used for outer parts (terraces and balconies) only. See <grill> (Grill data) for details.
relatedPartsarrayOther parts related to this one. Array of <relatedPart> elements. See <relatedPart> (Related part data) for details. This element is deprecated. See <relate> (Related data).
relatesetRelated data. See <relate> (Related data) for details.
sharesetSharing data. See <share> (Resource sharing data) for details.
<service> - Service data
terrTvboolIs terrestrial TV program available?
satTvboolIs satellite TV program available?
acsetAir conditioner usage data. See <ac> (Air conditioner data) for details.
centralHeatingsetCentral heating usage data. See <centralHeating> (Central heating data) for details.
kitchensetKitchen usage data. Kitchen service can exist only if accommodation unit type is room. See <kitchen> (Kitchen data) for details.
finalCleaningsetFinal cleaning data. See <finalCleaning> (Final cleaning service data) for details.
depositsetDeposit data. See <deposit> (Deposit data) for details.
petboolPet accommodation data.
<priceList> - Price list data
intervalsarrayPrices by intervals. Array of <interval> elements. See <interval> (Interval data) for details.
yearintPrice list year.
discountsarrayDiscounts and additional payments. Some types of discounts are related to accommodation unit, whilst others are related to the whole house. Discounts related to the whole house are applicable on every associated accommodation unit. Array of <discount> elements. See <discount> (Discount/additional payment data) for details.
lowPriceboolAccommodation unit has a low price?
<redirect> - Redirect links [URL]
URL links for redirection.
housestringHouse URL.
unitstringUnit URL.
orderstringOrdering URL.
<rating> - Ratings (1-5)
placeintAverage place rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
beachintAverage beach rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
accomodationintAverage accomodation rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
hostintAverage host rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
totalintTotal average rating. Element has the following attributes:
  • ratings [int]: Number of ratings.
<image> - Image
selfarrayImage variants. Array of <variant> elements. See <variant> (Image variant data) for details. Element has the following attributes:
  • type [type]: Image type (based on subject). Supported types are:
    • drawing
    • part
  • part [int]: Part ID. This value makes sense only if type has value of part.
  • view [bool]: Does image represent a view from part? This value makes sense only if type has value of part.
<bed> - Bed data
capacityintPerson capacity.
typetypeType. Supported types are:
  • single
  • double
  • foldaway
  • three_seater
  • two_seater
  • armchair
  • sofa
childrenboolIs it intended for children only?
<shade> - Sun shade data
existboolSun shade exists?
typetypeSun shade type. Supported types are:
  • natural
  • awning
  • canopy
<grill> - Grill data
existboolGrill exists?
firewoodsetFirewood data. See <firewood> (Firewood data) for details.
<relatedPart> - Related part data
selfintRelated part ID. Element has the following attributes:
  • direct [bool]: Is it directly connected? Eg. bedroom could have private (directly connected) toilet.
<relate> - Related data
existboolIs part related with any other part?
partsarrayParts in our accommodation units (in our offering) which relate with this part. Array of <part> elements. See <part> (Related part data) for details.
hostboolIs part related with part used by the host?
otherUnitssetOther accommodation units (outside of our offering) which relate with this part. See <otherUnits> (Other accommodation units data) for details.
<share> - Resource sharing data
existboolIs resource shared with anyone?
hostboolIs resource shared with the host?
agencyUnitsarrayOur accommodation units (in our offering) which share the resource. Array of <unit> elements. See <unit> (Accommodation unit reference data) for details.
otherUnitssetOther accommodation units (outside of our offering) which share the resource. See <otherUnits> (Other accommodation units data) for details.
<ac> - Air conditioner data
existboolAir conditioner exists?
pricesetPricing data. See <price> (Pricing data) for details.
<centralHeating> - Central heating data
existboolCentral heating exists?
pricesetPricing data. See <price> (Pricing data) for details.
<kitchen> - Kitchen data
This is used only if accommodation unit type is room.
existboolKitchen exists?
pricesetPricing data. See <price> (Pricing data) for details.
sharesetSharing data. See <share> (Resource sharing data) for details. This element is deprecated. See <relate> (Related data).
<finalCleaning> - Final cleaning service data
existboolFinal cleaning service exists?
pricesetPricing data. See <price> (Pricing data) for details.
<deposit> - Deposit data
existboolDeposit exists?
pricesetPricing data. See <price> (Pricing data) for details.
<firewood> - Firewood data
existboolFirewood exists?
pricesetPricing data. See <price> (Pricing data) for details.
<interval> - Interval data
fromdateBegin of interval (format is YYYY-MM-DD). Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
todateEnd of interval (format is YYYY-MM-DD). Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST).
pricesarrayPrices by number of persons. First price is for maximum number of persons. Array of <price> elements. See <price> (Interval price data) for details.
<discount> - Discount/additional payment data
typetypeDiscount type. Supported types are:
  • special
  • most_wanted
  • extra_day
  • first_minute
namestringName.
valuesetPercent, money or freeDays value. See <value> (Discount/additional payment value) for details.
<value> - Discount/additional payment value
Percent, money or freeDays amount. Negative values are discounts, positive values are additional payments.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Value type. Supported types are:
    • percent
    • amount
    • extra_day
percentfloatPercent value.
amountfloatMoney amount value. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
freeDaysintNumber of free days. Element has the following attributes:
  • total [int]: Total number of days.
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large
    • s - small
    • m - medium
urlstringImage variant URL.
<price> - Pricing data
typetypePrice type. Supported types are:
  • extra - service is charged additionaly
  • extra_adult - service is charged additionaly only for adults
  • included - service is not charged additionaly
  • agreement - service price is subject of agreement with house owner
amountfloatPrice amount. Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
unittypePrice unit type. Supported types are:
  • onetime
  • day
  • person
  • person_day
  • hour
  • minute
  • second
  • page
  • kb
  • mb
  • gb
  • wash
  • call
<unit> - Accommodation unit reference data
selfstringAccommodation unit name. Element has the following attributes:
  • id [int]: Accommodation unit ID.
  • type [type]: Accommodation unit type.
  • label [string]: Accommodation unit character label. Used to distinguish multiple accommodation units with a same type, within the same house.
  • capacityBasic [int]: Basic capacity of the accommodation unit.
  • capacityAdditional [int]: Additional capacity of the accommodation unit.
<parts> - Related parts data
partsetRelated part data. See <part> (Part data) for details.
<otherUnits> - Other accommodation units data
existboolOther accommodation units exists?
countintCount of other accommodation units.
<part> - Related part data
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Related part ID.
  • type [string]: Related part type.
directboolIs it directly connected? Eg. bedroom could have private (directly connected) toilet.
thisUnitboolPart is used by this accommodation unit.
sharesetSharing data. See <share> (Resource sharing data) for details.
<price> - Interval price data
amountfloatPrice amount (per day). Element has the following attributes:
  • currency [string]: Three-letter currency code (according to ISO 4217 standard) in lowercase.
personsintNumber of persons.

Example usage

Retrieve data of private accommodation unit with ID 1868.

https://www.adriatic.hr/services/rest/
  ?method=Private_getUnit
  &id=1868
  &aid=af151
  &lang=sl
  &sig=2157c7bf020a291ccb305417651b00c4

Private_getAvailStatus

Get accommodation unit(s)'s availability status.

Request parameters

idlist Comma delimited list of accommodation unit IDs. Example: "1868,1869". This parameter is required.
i_fromdateBegin of interval. Allowed formats are YYYY-MM-DD and unix timestamp. This parameter is required.
i_todateEnd of interval. Allowed formats are YYYY-MM-DD and unix timestamp. This parameter is required.

Response

<status> - Availability data
availboolAll specified accommodation units are available? Element has the following attributes:
  • type [type]: Availability status type. Supported types are:
    • avail - available
    • unavail_temp - temporarily unavailable
    • unavail - unavailable
unitsarrayAvailability by accommodation unit. Array of <unit> elements. See <unit> (Accommodation unit availability) for details.
<unit> - Accommodation unit availability
selfn/a Element has no value. Element has the following attributes:
  • id [int]: Accommodation unit ID.
availboolAccommodation unit is available? Element has the following attributes:
  • type [type]: Availability status type. Supported types are:
    • avail
    • unavail_temp
    • unavail

Example usage

Get availability status of accommodation units with IDs 1868 and 1869 in date interval 2012-08-09 to 2012-08-15.

https://www.adriatic.hr/services/rest/
  ?method=Private_getAvailStatus
  &id=1868%2C1869
  &i_from=2012-08-09
  &i_to=2012-08-15
  &aid=af151
  &lang=sl
  &sig=6c3ba357b11e1072467ee3b2a8ce1663

Private_getUnavailDates

Get accommodation unit unavailable dates.

Request parameters

idintAccommodation unit ID. This parameter is required.

Response

<dates> - Unavailable dates data
selfarrayUnavailable dates (if any). Array of <date> elements. See <date> (Unavailable date data) for details.
<date> - Unavailable date data
selfdate Date string in YYYY-MM-DD format (ISO 8601). Time zone is Croatian - GMT+1 (+DST). Element has the following attributes:
  • type [type]: Availability status type. Supported types are:
    • unavail_temp
    • unavail

Example usage

Get unavailable dates of accommodation units with ID 2459.

https://www.adriatic.hr/services/rest/
  ?method=Private_getUnavailDates
  &id=2459
  &aid=af151
  &lang=sl
  &sig=f03e9ceae26269b266003f4e70a2efbe

Geo_find

Search geography locations (except beaches). Method is pagination aware (results are split across multiple pages).

Request parameters

idintComma delimited list of region, riviera and place IDs. Example: "re-2,ri-17,pl-106".
qstringSearch string (case insensitive).
q_matchtypeString matching mode. Hint: begin and begin_word modes can be used for implementation of location input field with autocomplete support. Supported types are:
  • substring - Anywhere in the string
  • begin - At the beginning of the string
  • begin_word - At the beginning of any word in the string
  • exact - Exact match
Default value is substring.
ttypeLocation type. Supported types are:
  • region
  • riviera
  • place
sorttypeSort criterion. Supported types are:
  • name - Location name
  • type - Location type
Default value is name.
sort_dirtypeSort direction. Supported types are:
  • asc - Ascending
  • desc - Descending
Default value is asc.
pageintPage number. Default value is 1.
limitintNumber of results per page (max. 25). Default value is 10.

Response

<list> - List data
itemsarrayItems on current page. Array of <item> elements. See <item> (List item data) for details.
pagersetSet of pager elements. See <pager> (List pager data) for details.
<item> - List item data
idstringLocation ID.
namestringLocation name.
typetypeLocation type. Supported types are:
  • region
  • riviera
  • place
rivierastringRiviera name. Available only if location type is place. Element has the following attributes:
  • id [string]: Riviera ID.
regionstringRegion name. Available only if location type is place or riviera. Element has the following attributes:
  • id [string]: Region ID.
imagearrayImage of location. Array of <variant> elements. See <variant> (Image variant data) for details.
coordinatessetGeography coordinates. Available only if location type is place. See <coordinates> (Geography coordinates) for details.
<pager> - List pager data
totalItemsintTotal items that match search criteria.
totalPagesintTotal pages.
currentPageintCurrent page.
pageLimitintMaximum number of items per page.
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large
    • s - small
    • m - medium
urlstringImage variant URL.
<region> - Region data
namestringRegion name.
rivierasarrayReferences to all rivieras which belong to this region. Array of <riviera_ref> elements. See <riviera_ref> for details.
imagesarrayRegion images. Array of <image> elements. See <image> for details.
<coordinates> - Geography coordinates
longitudedecimalGeographical longitude.
latitudedecimalGeographical latitude.
altitudedecimalGeographical altitude.

Example usage

Find geography locations with word 'hvar' in name.

https://www.adriatic.hr/services/rest/
  ?method=Geo_find
  &q=hvar
  &aid=af151
  &lang=sl
  &sig=b01c6631dac94943efe7fabcadcd8bc9

Geo_get

Retrieve geography location data. Supported location types are place, beach, riviera and region.

Request parameters

idstringGeography location data. This parameter is required.

Response

<location> - Location data
selfn/a Element has no value. Element has the following attributes:
  • id [string]: Location ID.
typetypeLocation type. Supported types are:
  • region
  • riviera
  • place
  • beach
regionsetRegion name. Available only if location type is region. See <region> (Region data) for details. Element has the following attributes:
  • id [string]: Region ID.
rivierasetRiviera name. Available only if location type is riviera. See <riviera> (Riviera data) for details. Element has the following attributes:
  • id [string]: Riviera ID.
placesetPlace name. Available only if location type is place. See <place> (Place data) for details. Element has the following attributes:
  • id [string]: Place ID.
beachsetBeach name. Available only if location type is beach. See <beach> (Beach data) for details. Element has the following attributes:
  • id [string]: Beach ID.
<region> - Region data
namestringRegion name.
rivierasarrayReferences to all rivieras which belong to this region. Array of <riviera> elements. See <riviera> (Riviera reference) for details.
imagesarrayRegion images. Array of <image> elements. See <image> (Image) for details.
<riviera> - Riviera data
namestringRiviera name.
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
typetypeRiviera type. Supported types are:
  • mainland
  • mainland_river
  • island
  • islands
  • island_bridge
  • peninsula
placesarrayReferences to all places which belong to this riviera. Array of <place> elements. See <place> (Place reference) for details.
imagesarrayRiviera images. Array of <image> elements. See <image> (Image) for details.
<place> - Place data
namestringPlace name.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
typetypePlace type. Supported types are:
  • large_city
  • tourist_city
  • small_city
  • cove
  • isolated
largerPlacesetLarger place data. See <largerPlace> (Larger place data) for details.
isletsetIslet data. See <islet> (Islet data) for details.
beachesGeneralsetGeneral info on beaches which belong to this place. See <beachesGeneral> (Place beaches data) for details.
beachesarrayReferences to all beaches which belong to this place. Array of <beach> elements. See <beach> (Beach reference) for details.
imagesarrayPlace images. Array of <image> elements. See <image> (Image) for details.
coordinatessetGeography coordinates. See <coordinates> (Geography coordinates) for details.
<beach> - Beach data
Note that beaches don't have names.
placestringPlace name. Element has the following attributes:
  • id [string]: Place ID.
rivierastringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
regionstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
typetypeMain beach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva
typesarrayAll available beach types. Array of <type> elements. See <type> (Beach type) for details.
accesstypeSea access type. Supported types are:
  • long_shallow
  • short_shallow
  • no_shallow
privateboolBeach is 'private' (isolated)?
naturalShadeboolBeach has a natural shade?
showerboolBeach has a shower?
entertainmentboolBeach has an entertainment content?
nudeOfficialboolBeach is official nudist beach?
nudeSuitableboolBeach is suitable for nudism?
othersetData of other beaches in the same place. See <other> (Other beaches data) for details.
imagesarrayBeach images. Array of <image> elements. See <image> (Image) for details.
<region> - Region reference
selfstringRegion name. Element has the following attributes:
  • id [string]: Region ID.
<riviera> - Riviera reference
selfstringRiviera name. Element has the following attributes:
  • id [string]: Riviera ID.
<place> - Place reference
selfstringPlace name. Element has the following attributes:
  • id [string]: Place ID.
<beach> - Beach reference
selfn/a Element has no value. Element has the following attributes:
  • id [string]: Beach ID.
<largerPlace> - Larger place data
existboolLarger place exists?
namestringLarger place name (only if the larger place exists).
idstringLarger place ID (only if the larger place exists).
boatTransportboolBoat transport is necessary to get to the larger place (only if the larger place exists)?
boatDistanceintBoat transport distance from larger place (nautical miles, only if the larger place exists).
<islet> - Islet data
existboolPlace is on an islet?
namestringIslet name (only if the islet exists).
transportCarboolCar can be transported onto the islet (only if the islet exists)?
<beachesGeneral> - Place beaches data
nudeOfficialboolPlace has an official nudism beach?
nudeSuitableboolPlace has a beach suitable for nudism?
entertainmentboolPlace has a beach with an entertainment content?
naturalShadeboolPlace has a beach with a natural shade?
showerboolPlace has a beach with a shower?
privateboolPlace has a beach that is 'private' (isolated)?
typetypeMain beach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva
typesarrayAll available beach types. Array of <type> elements. See <type> (Beach type) for details.
accesstypePlace has a beach with this access type. Supported types are:
  • long_shallow
  • short_shallow
  • no_shallow
<other> - Other beaches data
typetypeMain beach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva
typesarrayAll available beach types. Array of <type> elements. See <type> (Beach type) for details.
accesstypeSea access type. Supported types are:
  • long_shallow
  • short_shallow
  • no_shallow
nudeOfficialboolOfficial nudism beach?
nudeSuitableboolSuitable for nudism?
entertainmentboolEntertainment content?
naturalShadeboolNatural shade?
showerboolHas shower?
privatebool'Private' (isolated)?
<image> - Image
selfarrayImage variants. Array of <variant> elements. See <variant> (Image variant data) for details. Element has the following attributes:
  • type [type]: Image type (only for place). Supported types are:
    • place
    • beaches
<variant> - Image variant data
Image variants are versions of the same image, differentiated by size, listed if exist.
selfn/a Element has no value. Element has the following attributes:
  • type [type]: Image variant type (size class). Supported types are:
    • l - large
    • s - small
    • m - medium
urlstringImage variant URL.
<coordinates> - Geography coordinates
longitudedecimalGeographical longitude.
latitudedecimalGeographical latitude.
altitudedecimalGeographical altitude.
<type> - Beach type
selftypeBeach type. Supported types are:
  • sand
  • pebble
  • stone
  • concrete
  • sharp_stone
  • riva

Example usage

Retrieve data of place with ID 'pl-220'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=pl-220
  &aid=af151
  &lang=sl
  &sig=eaee7df5be098c4cabd98959f69e910f

Retrieve data of beach with ID 'be-223'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=be-223
  &aid=af151
  &lang=sl
  &sig=eaee7df5be098c4cabd98959f69e910f

Retrieve data of riviera with ID 'ri-17'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=ri-17
  &aid=af151
  &lang=sl
  &sig=eaee7df5be098c4cabd98959f69e910f

Retrieve data of region with ID 're-1'.

https://www.adriatic.hr/services/rest/
  ?method=Geo_get
  &id=re-1
  &aid=af151
  &lang=sl
  &sig=eaee7df5be098c4cabd98959f69e910f

Geo_getNames

Retrieve geography location names. Supported location types are place, riviera and region. Method can be used for implementation of location input field with autocomplete support.

Request parameters

None

Response

<names> - Location names
selfarrayNames of all available locations (except beaches). Array of <name> elements. See <name> (Location name) for details.
<name> - Location name
selfstring Element has the following attributes:
  • id [string]: Location ID.
  • type [type]: Location type. Supported types are:
    • region
    • riviera
    • place
  • parentId [string]: Parent location ID.

Example usage

Get geography location names.

https://www.adriatic.hr/services/rest/
  ?method=Geo_getNames
  &aid=af151
  &lang=sl
  &sig=2887345166a8e931f218270b6421849b

System_getText

Retrieve method text.

Request parameters

mtypeMethod name. Supported types are:
  • Geo_find
  • Geo_get
  • Geo_getNames
  • Private_find
  • Private_findReviews
  • Private_getHouse
  • Private_getUnit
  • Private_getAvailStatus
  • Private_getUnavailDates
  • Order_get
  • Order_addItem
  • Order_setNotes
This parameter is required.

Response

<text> - Text data
selfn/a Element has no value. Element has the following attributes:
  • method [string]: Method name.
paramsarrayMethod parameters with associated text. Array of <param> elements. See <param> (Method parameter data) for details.
nodesarrayMethod response XML nodes with associated text. Array of <node> elements. See <node> (Method response XML node data) for details.
typesarrayTypes with associated text. Array of <type> elements. See <type> (Type data) for details.
<param> - Method parameter data
selfstringParameter text. Element has the following attributes:
  • name [string]: Parameter name.
<node> - Method response XML node data
selfstringNode text. Element has the following attributes:
  • path [string]: XPath path.
<type> - Type data
paramsarrayMethod parameters which use this type. Array of <param> elements. See <param> (Method parameter name) for details.
nodesarrayMethod response XML nodes which use this type. Array of <node> elements. See <node> (Method response XML node path) for details.
optionsarrayType options. Array of <option> elements. See <option> (Type option data) for details.
<param> - Method parameter name
selfstringParameter name.
<node> - Method response XML node path
selfstringXPath path.
<option> - Type option data
selfstringOption text. Element has the following attributes:
  • name [string]: Option name.

Example usage

Retrieve text of method Geo_find.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Geo_find
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Geo_get.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Geo_get
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_find.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_find
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_findReviews.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_findReviews
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getHouse.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getHouse
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getUnit.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getUnit
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getAvailStatus.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getAvailStatus
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Private_getUnavailDates.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Private_getUnavailDates
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Order_get.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Order_get
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Order_addItem.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Order_addItem
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

Retrieve text of method Order_setNotes.

https://www.adriatic.hr/services/rest/
  ?method=System_getText
  &m=Order_setNotes
  &aid=af151
  &lang=sl
  &sig=25553b551636e9346ed33da7286ee7de

System_getError

Retrieve error text translation.

Request parameters

codeintError code. This parameter is required.

Response

<error> - Error data
messagetextTranslated error message. Element has the following attributes:
  • code [int]: Error code.

Example usage

Retrieve error message translation for error code 200.

https://www.adriatic.hr/services/rest/
  ?method=System_getError
  &code=200
  &aid=af151
  &lang=sl
  &sig=68f132dd19aff816ac67e0e5e56c308c

Retrieve error message translation for error code 217.

https://www.adriatic.hr/services/rest/
  ?method=System_getError
  &code=217
  &aid=af151
  &lang=sl
  &sig=68f132dd19aff816ac67e0e5e56c308c

Številke objektov

Kontakt

  • Washingtonova 5
  • 21000 Split, Hrvaška
  • tel: +385 21 456-456
  • fax: +385 21 456-789
  • gsm: +385 91 234-5641
  • e-mail: info@adriatic.hr
  • oib: 16364086764
  • ID: HR-AB-21-020038491