This is an old revision of the document!
Set the handicap of a relation or mamber. This will only work if there are no entries present in the handicap administration of intogolf. Also note that using this API will changed the timestamp of the relation, so the next time you request /itg/getrelations?date=yyyymmdd or /itg/getmembers this relation will be fetched as well.
parameters:
auth | the authorisation code you received from Intogolf BV (mandatory) |
handicap | the new handicap (format 99.9) |
relnr | |
relnrlocal | specify the relation to be changed by local id within the domain of the golfcourse |
mbrcode | specify the relation(s) to be changed by membercode |
ngfnumber | specify the relation(s) to be changed by ngf number |
debtorid | specify the relation(s) to be changed by debtorid |
externalid | specify the relation(s) to be changed by externalid |
You need to specify at least one of the parameters (apart from auth and handicap of course). There is no guarantee that the parameters relnr, mbrcode, ngfnumber, debtorid, externalid will point to only 1 relation. It is possible that multiple relations exist with the id and that the handicap of multiple relations will be changed. Only relnrlocal is always unique.
If a wrong authorisation code is provided, the backend will return 401,“Unauthorized”
example: https://backend.intogolf.com/itg/sethandicap?auth=<your authorisation code>&relnr=659764&handicap=23.4
result:
{ "sethandicap": [ { "relnr": 659764, "relnrlocal": 123456, "handicap": "23.4" } ] }
This API returns all records (normally only 1) that have been changed