User Tools

Site Tools


getflight

This is an old revision of the document!


/itg/getflight

To retrieve detailed data of teetime reservations (called flights). This function is meant for operational purposes, not for management info or statistics.

parameters:

auth the authorisation code you received from Intogolf BV (mandatory)
fltnr internal id of the flight
relnr internal id of a golfer within the domain of ikgagolfen
relnrlocal local id of a golfer within the domain of the golfcourse
startdate date the flightreservation is made for (format YYYYMMDD)
starttime time the flightreservation is made for in minutes since midnight (600 = 10 o'clock, 720 is noon)

At least one of the parameters fltnr, relnr, relnrlocal, startdate, strttime is needs to be provided, otherwise the return code 449 - Retry with valid parameters is returned.

If the parameters fltnr and/or startdate are nort provided, the resultset will always be limited to startdates >= today

If the parameter fltnr is provided all other selection parameters are ignored.

If the parameter fltnr is not provided, only non-canceled flights are returned.

If the result set is longer than 1000 records, it will be truncated.

example: https://backend.intogolf.com/itg/getflight?auth=<your authorisation code>&relnr=659764&startdate=20130530

To obtain the flight for the golfer with id 659764 (see igg/getgolfer) for may 30th, 2013

result (shortened for readability):

{
{
  "getflight": [
    {
      "fltnr": 3436124,
      "startdate": 735383,
      "starttimebooked": 510,
      "starttimefixed": false,
      "starttime": 510,
      "breaktime": 0,
      "time2": 630,
      "crlnr1": 44,
      "crlnr2": 70,
      "nrofplayers": 3,
      "nomerging": false,
      "origin": 1,
      "timestamp": "2013-05-23T16:07:45+02:00",
      "carnr": 0,
      "carname": null,
      "players": [
        {
          "flpnr": 11162606,
          "relnr": 659764,
          "relnrlocal": 12590,
          "name": "knol-pas, s.a.w.",
          "phone": "0135159339",
          "handicap": 54.0,
          "grfnr": 4,
          "grfname": "lid (gratis)",
          "greenfee": 0.0,
          "grfnrdiscount": 0,
          "grfnamediscount": null,
          "discount": 0.0,
          "gfcnr": 0,
          "gfcnrdiscount": 0,
          "scorecardnr": 0,
          "qualifyingnr": 0,
          "carnr": 0,
          "rentals": [
            {
              "rentalnr": 155200,
              "rentaltypenr": 121,
              "rentaltype": "handicart",
              "rentalitemnr": 93,
              "rentalitem": "handicart 2",
              "rentaltimefrom": 510,
              "rentaltimeto": 750,
              "extratimebefore": 10,
              "extratimeafter": 15,
              "extrainfo": "",
              "rentalprice": 0.0,
              "checkedin": false
            }
          ]
        },
        {
          "flpnr": 11162607,
          "relnr": 701160,
          "relnrlocal": 193732,
          "name": "knol, r.j.w.",
          "phone": "0135159339",
          "handicap": 54.0,
          "grfnr": 57,
          "grfname": "greenfee",
          "greenfee": 47.25,
          "grfnrdiscount": 48,
          "grfnamediscount": "bonus",
          "discount": 5.0,
          "gfcnr": 0,
          "gfcnrdiscount": 0,
          "scorecardnr": 0,
          "qualifyingnr": 0,
          "carnr": 0,
          "rentals": [
            {
              "rentalnr": 155199,
              "rentaltypenr": 36,
              "rentaltype": "trolley",
              "rentalitemnr": null,
              "rentalitem": null,
              "rentaltimefrom": 510,
              "rentaltimeto": 750,
              "extratimebefore": 0,
              "extratimeafter": 0,
              "extrainfo": "",
              "rentalprice": 0.0,
              "checkedin": false
            }
          ]
        },
        {
          "flpnr": 11162608,
          "relnr": 243520,
          "relnrlocal": 22359,
          "name": "aikema, annerie",
          "phone": "0118561413",
          "handicap": 45.0,
          "grfnr": 340,
          "grfname": "10 rittenkaart",
          "greenfee": 0.0,
          "grfnrdiscount": 0,
          "grfnamediscount": null,
          "discount": 0.0,
          "gfcnr": 12365,
          "gfcnrdiscount": 0,
          "scorecardnr": 0,
          "qualifyingnr": 0,
          "carnr": 0,
          "gfcname": "10 rittenkaart",
          "gfcdatefrom": 735376,
          "gfcdateto": 735740,
          "totalrounds": 10,
          "usedrounds": 0,
          "rentals": [

          ]
        }
      ]
    }
  ]
}

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

getflight.1369322674.txt.gz · Last modified: 2013/05/23 16:24 (external edit)