Web APIs return data that can be consumed on a broad range of clients, including browsers, mobile devices, and traditional desktop applications.A data returned by the WebAPI will be in either XML or JSON format.The format, or content type, is determined by means of content negotiation between the API and the requesting device via the Accept header,which is specific to the type of device sending the request.
There are six Web APIs available in D!BS. The table below briefly describes each WebAPI and outlines the structure of the returned data. The language of the returned data structure is shown in XML (attributes appearing in the root element are omitted for clarity). In the Web API and Description column, the data variables are in bold italics. In the Structure of Returned Data column, the data types are in bold italics.
Web API and Description | Structure of Returned Data |
Buildings API … /dibsapi/buildings Returns data of the complete list of buildings |
< ArrayOfDibsBuilding> < DibsBuilding> <BuildingID> Integer </BuildingID> <Description>String</Description> <Latitude>Decimal</Latitude> <Longitude>Decimal</Longitude> <Name>String</Name> <Picture>Url</Picture> </ DibsBuilding> </ ArrayOfDibsBuilding > |
Building-By-ID API … /dibsapi/buildings/id Returns data for one building given the building’sid |
< DibsBuilding> <BuildingID> Integer </BuildingID> <Description>String</Description> <Latitude>Decimal</Latitude> <Longitude>Decimal</Longitude> <Name>String</Name> <Picture>Url</Picture> </ DibsBuilding> |
Rooms API … /dibsapi/rooms Returns data of the complete list of all rooms |
<ArrayOfDibsRoom> < DibsRoom > <BuildingID>Integer</BuildingID> <Description> String </Description> <Map>Url</Map> <Name>String</Name> <Picture>Url</Picture> <RoomID> Integer </RoomID> </ DibsRoom > </ ArrayOfDibsRoom > |
Room-By-ID API … /dibsapi/rooms/id Returns data for one room given the room’s id |
< DibsRoom > <BuildingID>Integer</BuildingID> <Description> String </Description> <Map>Url</Map> <Name>String</Name> <Picture>Url</Picture> <RoomID> Integer </RoomID> </ DibsRoom > |
Room-Hours API … /dibsapi/roomHours/ yyyy-mm-dd / id Returns the opening and closing time for a room by date and room id |
< ArrayOfDibsRoomHours > < DibsRoomHours > <EndTimeHour>DateTime<EndTimeHour> <RoomID>Integer</RoomID> <StartTimeHour>DateTime<StartTimeHour> </ DibsRoomHours > </ ArrayOfDibsRoomHours > |
Reservations API … /dibsapi/reservations/yyyy-mm-dd / id Returns time slots of existing reservations by date and room id |
Article ID: 480
Created On: Mon, Nov 19, 2012 at 11:55 AM
Last Updated On: Mon, Aug 19, 2019 at 10:02 AM
Online URL: https://kb.demcosoftware.com/article.php?id=480