Differences

This shows you the differences between two versions of the page.

--- getscorecard [2013/11/27 10:14]
richard created
+++ getscorecard [2013/11/27 10:42] (current)
@@ Line 4: / Line 4: @@
 parameters:
 |auth	|the authorisation code you received from Intogolf BV (mandatory)|
-|chhnr	|the id of the golfer (mandatory)|
+|relnr  |the id of the golfer (mandatory) |
-|showpractise	|if 1 the result will also include non-qualifying rounds|
+|rscnr  |the id of the scorecard |
+|epenr	|the id of the player within a competition|
+|chhnr  |the id of the registration in the handicap history|
+|ihhnr  |the id of the registration in the table with practise rounds.|
+Any one of the parameteres rscnr, epenr, chhnr or ihhnr is mandatory. Only one of these is needed, depending on the type of registration. If you know the id of the score card itself it is best to use only the rscnr.
-example: https://backend.ikgagolfen.nl/igg/gethandicaphistory?auth=<your authorisation code>&645347&showpractise=0
+example: https://backend.ikgagolfen.nl/hcp/getscorecard?auth=<your authorisation code>&relnr=12590&epenr=234270
 result:
 <code>{
-  "gethandicaphistory": [
+{
+  "getscorecard": [
     {
-      "ihhnr": 0,
+      "rscnr": 63989,
-      "chhnr": 0,
+      "relnr": 12590,
-      "epenr": 188417,
+      "date": 20131126,
-      "playdate": "20121205",
+      "time": 600,
-      "hctnr": 3,
+      "ratnr": 123,
-      "stableford": 3,
+      "coursename": "Golfbaan het Balletje",
-      "handicapold": 16.6,
-      "handicapnew": 0.0,
       "holes": 18,
-      "hcpactive": 0,
+      "teenr": 13,
-      "cba": 0,
+      "par": 72,
-      "course": "mixed ochtend NQ",
+      "sr": 113,
-      "remark": ""
+      "cr": 72.0,
-    },
+      "handicap": 22.4,
-    {
+      "playinghandicap": -25,
-      "ihhnr": 0,
+      "marker": "Henk de Groot",
-      "chhnr": 61674,
+      "strokes": 72,
-      "epenr": 0,
+      "stf": 36,
-      "playdate": "20121128",
+      "par1": 4,
-      "hctnr": 2,
+      "si1": 3,
-      "stableford": 2,
+      "hcpstrokes1": 4,
-      "handicapold": 16.9,
+      "strokes1": 4,
-      "handicapnew": 16.6,
+      "stf1": 2,
-      "holes": 18,
+      "par2": 4,
-      "hcpactive": 1,
+      "si2": 11,
-      "cba": 0,
+      "hcpstrokes2": 4,
-      "course": "De Turfvaert - De Turfvaert 18 holes",
+      "strokes2": 4,
-      "remark": "strokeplay winst, fred blans 1e wedstrijd"
+      "stf2": 2,
-    },
+      "par3": 3,
-    {
+      "si3": 13,
-      "ihhnr": 0,
+      "hcpstrokes3": 3,
-      "chhnr": 0,
+      "strokes3": 4,
-      "epenr": 186203,
+      "stf3": 1,
-      "playdate": "20121114",
+      "par4": 5,
-      "hctnr": 3,
+      "si4": 1,
-      "stableford": 3,
+      "hcpstrokes4": 5,
-      "handicapold": 17.8,
+      "strokes4": 4,
-      "handicapnew": 16.9,
+      "stf4": 3,
-      "holes": 18,
+      "par5": 3,
-      "hcpactive": 0,
+      "si5": 17,
-      "cba": 0,
+      "hcpstrokes5": 3,
-      "course": "mixed ochtend NQ",
+      "strokes5": 4,
-      "remark": ""
+      "stf5": 1,
-    },
+      "par6": 4,
+      "si6": 9,
+      "hcpstrokes6": 4,
+      "strokes6": 4,
+      "stf6": 2,
+      "par7": 4,
+      "si7": 15,
+      "hcpstrokes7": 4,
+      "strokes7": 4,
+      "stf7": 2,
+      "par8": 5,
+      "si8": 5,
+      "hcpstrokes8": 5,
+      "strokes8": 4,
+      "stf8": 3,
+      "par9": 4,
+      "si9": 7,
+      "hcpstrokes9": 4,
+      "strokes9": 4,
+      "stf9": 2,
+      "par10": 4,
+      "si10": 12,
+      "hcpstrokes10": 4,
+      "strokes10": 4,
+      "stf10": 2,
+      "par11": 5,
+      "si11": 4,
+      "hcpstrokes11": 5,
+      "strokes11": 4,
+      "stf11": 3,
+      "par12": 3,
+      "si12": 14,
+      "hcpstrokes12": 3,
+      "strokes12": 4,
+      "stf12": 1,
+      "par13": 4,
+      "si13": 10,
+      "hcpstrokes13": 4,
+      "strokes13": 4,
+      "stf13": 2,
+      "par14": 4,
+      "si14": 18,
+      "hcpstrokes14": 4,
+      "strokes14": 4,
+      "stf14": 2,
+      "par15": 4,
+      "si15": 2,
+      "hcpstrokes15": 4,
+      "strokes15": 4,
+      "stf15": 2,
+      "par16": 3,
+      "si16": 16,
+      "hcpstrokes16": 3,
+      "strokes16": 4,
+      "stf16": 1,
+      "par17": 4,
+      "si17": 8,
+      "hcpstrokes17": 4,
+      "strokes17": 4,
+      "stf17": 2,
+      "par18": 5,
+      "si18": 6,
+      "hcpstrokes18": 5,
+      "strokes18": 4,
+      "stf18": 3,
+      "remark": null
+    }
   ]
 }</code>
-|ihhnr |internal id of the record in the handicap history of practise rounds|
+|rscnr |internal id of the scorecard|
-|chhnr |internal id of the record in the handicap history|
+|date |date the round was played (format yyyymmdd)|
-|epenr |internal id of the record that represents the golfer in the competition (if applicable)|
+|time |starttime at which the round was played in minutes since midnight|
-|playdate |date the round was played (format yyyymmdd)|
+|ratnr|id of the measured course|
-|hctnr |type of the handicaphistory record. possible values are: 1-set initial handicap, 2-qualifying card, 3-competition result, 4-no return, 5-revoke handicap, 6-manual handicap adjustment, 7-annual handicap evaluation, 8-non qualifying card, 9-no show, 10-disqualified|
+|teenr|id of the tee used|
-|stableford |stableford points|
+|par |par of the course|
-|handicapold |handicap before this card is computed |
+|sr |slope rating of the course|
-|handicapnew |handicap after this card is applied|
+|cr |course rating of the course|
-|holes |nr of holes played|
+|handicap |handicap of the golfer as used fot this card|
-|hcpactive |1 if the handicap is active, 0 if not active|
+|playinghandicap |playing handicap used for this card|
-|cba | value that was used for cba in case of a competition |
+|marker |name of the marker|
-|course |name of the course played or name of the competition played|
+|strokes | total strokes |
-|rmark |remark entered by the user |
+|stf |total stableford points|
+|par1 .. 18 |par of the hole |
+|si1 .. 18 |stroke index of the hole |
+|hcpstrokes1 .. 18 |nr of strokes based on stroke index and playing handicap |
+|strokes1 .. 18 |nr of strokes played |
+|stf1 .. stf18 |nr of computed stableford points for the hole |
-if a wrong authorisation code is provided, the backend will return no result
+if a wrong authorisation code is provided, the backend will return 401, Unauthorized
+if a wrong set of parameters is used, the backend will return 406, Not found

Intogolf Wiki

User Tools

Site Tools

Differences

Page Tools