MakePlans API

Introduksjon

Vårt API er REST-basert og støtter input/output av JSON og XML.

Autentisering

All bruk av API krever at man autentiserer med http-basic. Brukernavn er en API-nøkkel og passordet er tomt. Ta kontakt med oss for å opprette API-nøkkel for din konto.

Eksempel

For å hente ut en liste over alle ressurser gjør følgende http-kall:

curl -u APIKEY: -H "Accept:application/json" -H "Content-Type: application/json" -X GET http://KONTONAVN.makeplans.no/manage/resources.json

Hvis du vil benytte XML bytter du ut application/json med application/xml og resources.json med resources.xml

Ny booking

Bookinger gjøres på ressurser. Det er flere mer à gjennomføre en booking på ressur
  1. Spesifisere resource_id. Kan også spesifisere service_id (anbefales).
  2. Spesifisere selected_resources. MakePlans vil da finne en tilfeldig ledig ressurs blant de spesifiserte. Kan også spesifisere service_id (anbefales).
  3. Spesifisere kun service_id. MakePlans vil da finne en tilfeldig ledig ressurs blant de ressurser som tilbyr den spefisiserte tjenesten.

curl -u APIKEY: -H "Accept:application/json" -H "Content-Type: application/json" -X POST http://KONTONAVN.makeplans.no/manage/bookings.json -d "{'booking': {'service_id': 14, 'booked_from' : '02.05.2010 12:00:00', 'booked_to' : '02.05.2010 13:00:00', 'person_attributes' : { 'name' : 'Espen Antonsen'} } }"

Parametre:

Feltnavn Påkrevd Datatype Eksempel
Service_Id Nei Integer 14
Resource_Id Nei Integer 20
Booked_from Ja Dato (ISO 8601) 2010-10-05T10:00:00+02:00
Booked_to Ja Dato (ISO 8601) 2010-10-05T10:30:00+02:00
E-mail Nei String espen@makeplans.no
Navn Ja String Espen Antonsen