User Tools

Site Tools


proagendas

/igg/proagendas

Retrieve a list of all available lessons for the golf professionals (tutors) of a specific course.

parameters:

auth the authorisation code you received from Intogolf BV (mandatory)
crsnr the id of the course (mandatory)
date the date the golfer wants to have a lesson (mandatory)
relnr show only the available slots for this golfer (checks the golfers category)
pronr show only the agenda of this professional
pltnr show only the available slots for this lesson type
players show only the avalable slots for this nr of golfers

example: https://backend.ikgagolfen.nl/igg/proagendas?auth=<your authorisation code>&crsnr=13&date=20120928

result (shortened):

{
  "proagendas": [
    {
      "time": 720,
      "date0": "20120928",
      "pronr0": 175864,
      "proname0": "Stef  Gresel",
      "duration0": 240,
      "date1": "00000000",
      "pronr1": 0,
      "proname1": "",
      "duration1": 0,
      "date2": "00000000",
      "pronr2": 0,
      "proname2": "",
      "duration2": 0,
      "date3": "20120930",
      "pronr3": 51264,
      "proname3": "Barbara van Strien",
      "duration3": 55,
      "date4": "00000000",
      "pronr4": 0,
      "proname4": "",
      "duration4": 0
    },
    {
      "time": 750,
      "date0": "20120928",
      "pronr0": 175864,
      "proname0": "Stef  Gresel",
      "duration0": 210,
      "date1": "00000000",
      "pronr1": 0,
      "proname1": "",
      "duration1": 0,
      "date2": "00000000",
      "pronr2": 0,
      "proname2": "",
      "duration2": 0,
      "date3": "00000000",
      "pronr3": 0,
      "proname3": "",
      "duration3": 0,
      "date4": "00000000",
      "pronr4": 0,
      "proname4": "",
      "duration4": 0
    },
    {
      "time": 780,
      "date0": "20120928",
      "pronr0": 175864,
      "proname0": "Stef  Gresel",
      "duration0": 180,
      "date1": "20120928",
      "pronr1": 51264,
      "proname1": "Barbara van Strien",
      "duration1": 60,
      "date2": "20120929",
      "pronr2": 51264,
      "proname2": "Barbara van Strien",
      "duration2": 60,
      "date3": "00000000",
      "pronr3": 0,
      "proname3": "",
      "duration3": 0,
      "date4": "20121001",
      "pronr4": 51264,
      "proname4": "Barbara van Strien",
      "duration4": 180
    },
    {
      "time": 810,
      "date0": "20120928",
      "pronr0": 175864,
      "proname0": "Stef  Gresel",
      "duration0": 150,
      "date1": "00000000",
      "pronr1": 0,
      "proname1": "",
      "duration1": 0,
      "date2": "00000000",
      "pronr2": 0,
      "proname2": "",
      "duration2": 0,
      "date3": "00000000",
      "pronr3": 0,
      "proname3": "",
      "duration3": 0,
      "date4": "20121001",
      "pronr4": 51264,
      "proname4": "Barbara van Strien",
      "duration4": 150
    },
  ]
}

The records are ordered by the starttime of the lesson. This is usually in intervals of 30 of 60 minutes. The attributes date0, pronr0, proname0 and duration0 belong together. This was there are always 5 columns that can be shown.

Have a look at this section: “time”: 810, “date0”: “20120928”, “pronr0”: 175864, “proname0”: “Stef Gresel”, “duration0”: 150, It means that on 810 (13:30) on september 28th, Stef Gresel has an available spot in his agenda for max. 150 minutes. This available spot is to be shown in the first column.

Now look at this section in the same record: “date4”: “20121001”, “pronr4”: 51264, “proname4”: “Barbara van Strien”, “duration4“: 150 Since it is in the same record, the start time is still 810 (13:30). It means that Barbara van Strien has an available slot in her agenda on October 1st for max. 150 minutes. This slot should be shown in the 5th column.

If you look 1 record before this at the time 780 (13:00) you see this section: “date4”: “20121001”, “pronr4”: 51264, “proname4”: “Barbara van Strien”, “duration4”: 180 Apparently Barbara was already available 30 minutes earlier. And if you would book your lesson in this slot the max. duration of you lesson could be 180 minutes. Of course you’d only be able to book a lesson of 180 minutes if there would be a lessontype available in the /igg/lessontypes resultset that lasts for 180 minutes, which is unlikely.

if there is nothing available or the date is not provided, an empty array is returned

{
  "proagendas": [

  ]
}

if a crsnr that does not allow lesson bookings is provided, the backend will return “no lessons for this course”

if a wrong authorisation code is provided, the backend will return “no authorisation”

proagendas.txt · Last modified: 2012/12/14 15:50 (external edit)