login
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
login [2012/12/14 10:51] richard |
login [2013/10/09 09:48] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | /igg/login | + | ==== /igg/login ==== |
| This request can be used for both login and for requesting golfer data. It will return a set of user records that match the login parameters. With the amount of golfers that are entered and maintained at the various golfcourses and ikgagolfen.nl it is very hard to keep each client in the database unique. Therefor, logging in, will not always produce just 1 matching record. For instance: | This request can be used for both login and for requesting golfer data. It will return a set of user records that match the login parameters. With the amount of golfers that are entered and maintained at the various golfcourses and ikgagolfen.nl it is very hard to keep each client in the database unique. Therefor, logging in, will not always produce just 1 matching record. For instance: | ||
| A golfer is registered 3 times and the login parameters name, initials, birthdate and phone number are provided. This may result in 2 records because the phone nr of 1 of the 3 registrations was entered wrong. Of course the security level is very low if you login like this. The security level is returned in the resultset and your application should act according to this security level. For instance: Do not allow the user to set a new password if the securitylevel is 7 or lower. | A golfer is registered 3 times and the login parameters name, initials, birthdate and phone number are provided. This may result in 2 records because the phone nr of 1 of the 3 registrations was entered wrong. Of course the security level is very low if you login like this. The security level is returned in the resultset and your application should act according to this security level. For instance: Do not allow the user to set a new password if the securitylevel is 7 or lower. | ||
| Line 13: | Line 13: | ||
| parameters: | parameters: | ||
| |auth | the authorisation code you received from Intogolf BV (mandatory)| | |auth | the authorisation code you received from Intogolf BV (mandatory)| | ||
| + | |pwd | client password (mandatory) or authHash| | ||
| |relnr | client id| | |relnr | client id| | ||
| |email | email address| | |email | email address| | ||
| - | |pwd | client password| | ||
| |name | last name (without van der)| | |name | last name (without van der)| | ||
| - | |initials |client initials (as R.J.W. not RJW)| | ||
| - | |prefix |name prefix (van, van der)| | ||
| - | |callname |first name (Richard)| | ||
| - | |address |street and house number (Zijstraat 7)| | ||
| - | |pc |postal code (without spaces 5176NG)| | ||
| - | |city |city name (no synonim matching available: ‘s Hertogenbosch and Den Bosch will be different cities)| | ||
| - | |phone |client phone number of mobile phone number (only digits 0135159339)| | ||
| - | |birthdate |client birth date (YYYYMMDD)| | ||
| - | |gender |1 - male, 2 - female| | ||
| |ngf |dutch official golfer id (typically a 6 or 7 digit number)| | |ngf |dutch official golfer id (typically a 6 or 7 digit number)| | ||
| |gpp |dutch official golfpassport id| | |gpp |dutch official golfpassport id| | ||
| Line 31: | Line 22: | ||
| You can provide any combination of parameters. The best results will be: | You can provide any combination of parameters. The best results will be: | ||
| - | - relnr and pwd | + | * relnr and pwd |
| - | - email and pwd | + | * email and pwd |
| - | name and pwd | + | * name and pwd |
| - | (warning: eventhought the securitylevel of these combinations will be very high, it is still no guarantee for a result set of 1 record only, because people may have double registrations with the same password) | + | (warning: eventhough the securitylevel of these combinations will be very high, it is still no guarantee for a result set of 1 record only, because people may have double registrations with the same password) |
| - | Or you can provide at least 3 of the following parameters: | + | When you have an authHash value for a client you can supply the authHash value in the pwd field. In this case the relnr field is mandatory. You can retrieve the clients authHash by loggin in as described above or with [[addrelation|/igg/addrelation]]. |
| - | - name | + | |
| - | + | Please note that a relnr may become invalid at some point in time due to merging double accounts or deleting accounts. | |
| - | address | + | |
| - | pc | + | |
| - | phone | + | |
| - | birthdate | + | |
| - | ngf | + | |
| - | gpp | + | |
| Example: https://backend.ikgagolfen.nl/igg/login?auth=<your authrisation code here>&email=richard@intogolf.com&pwd=golf | Example: https://backend.ikgagolfen.nl/igg/login?auth=<your authrisation code here>&email=richard@intogolf.com&pwd=golf | ||
| result: | result: | ||
| - | { | + | <code>{ |
| "login": [ | "login": [ | ||
| { | { | ||
| "relnr": 602234, | "relnr": 602234, | ||
| "name": "R.J.W. Knol", | "name": "R.J.W. Knol", | ||
| + | "lastname": "Knol", | ||
| + | "nameprefix": "", | ||
| + | "initials": "R.J.W.", | ||
| + | "firstname": "Richard", | ||
| "mv": 2, | "mv": 2, | ||
| "email": "richard@intogolf.com", | "email": "richard@intogolf.com", | ||
| Line 63: | Line 52: | ||
| "privacy": 0, | "privacy": 0, | ||
| "securitylevel": 9, | "securitylevel": 9, | ||
| - | "relkey": "68de29c0547a5c23ad51f62154d1177c" | + | "relkey": "68de29c0547a5c23ad51f62154d1177c", |
| + | "authHash": "8c3a492b9bd0740d702a88c5776f8762" | ||
| } | } | ||
| ] | ] | ||
| } | } | ||
| + | </code> | ||
| The resultset attributes are self-explanatory except for: | The resultset attributes are self-explanatory except for: | ||
| - | mv the gender | + | |mv |the gender| |
| - | golferid corresponds to the parameter “ngf” | + | |golferid |corresponds to the parameter “ngf”| |
| - | relkey This hash key needs to be stored and is later on needed when you want to retrieve any personal data for the golfer | + | |relkey |This hash key needs to be stored and is later on needed when you want to retrieve any personal data for the golfer. Beware that the combination relnr and relkey will not be valid forever. A user account can be deleted or merged to prevent doubles, in which case the relnr and relkey will become invalid. If you use an invalid relkey or a valid relkey in combination with a deleted relnr 401: Unauthorized will be returned when you try to use the relnr + relkey ombination in one of the other API functions| |
| - | privacy if 1, the user has checked a box indicating that he does not want his name to appear in search lists on other user’s sessions. For instance: you can not select them as co player unless they are in your friends lists. You can not add them to your friends list either, because they are not visible when you search for them. Your application will need to respect this. People with privacy set to 1 wil only appear in your result list if the securitylevel is at least 8, which means that he logged in with his password. | + | |privacy |if 1, the user has checked a box indicating that he does not want his name to appear in search lists on other user’s sessions. For instance: you can not select them as co player unless they are in your friends lists. You can not add them to your friends list either, because they are not visible when you search for them. Your application will need to respect this. People with privacy set to 1 wil only appear in your result list if the securitylevel is at least 8, which means that he logged in with his password.| |
| - | sid if getoldstylesessionid=1 you will receive a session id to pass to the old style ikgagolfen iframes as &sid=<sessionid>&q=<checksum> | + | |sid |if getoldstylesessionid=1 you will receive a session id to pass to the old style ikgagolfen iframes as &sid=<sessionid>&q=<checksum>| |
| - | q if getoldstylesessionid=1 you will receive a checksum with the session to pass to the old style ikgagolfen iframes as &sid=<sessionid>&q=<checksum> | + | |q |if getoldstylesessionid=1 you will receive a checksum with the session to pass to the old style ikgagolfen iframes as &sid=<sessionid>&q=<checksum>| |
| If a wrong authorisation code is provided, the backend will return “no authorisation” | If a wrong authorisation code is provided, the backend will return “no authorisation” | ||
| - | |||
login.1355482274.txt.gz · Last modified: 2012/12/14 10:51 by richard
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
