[ADC-Ext 1.0.8] OID - Exchange Online IDs
Posted: 17 May 2013, 12:46
The purpose of the OID command is to allow users to exchange information about their accounts on various online services. The name of the command has been intentionally chosen to be similar to OpenID, although its spread is broader.
A new command is preferrable here over new INF fields to avoid clogging up its 2-letter identifiers. It also allows for more flexibility: multiple profiles of the same type; multiple identification parameters.
Parameters of the OID command:
- Unnamed parameter in first position to designate the service this command is referring to. Known services are listed in the "Known OID services" document. Before using a new service, make sure it isn't on that list and let ADC managers know about it.
- Optional named parameters whose meanings depend on the service in question.
OID commands support all contexts (hub-client, client-client). It is supported in the client-client context were users to want to avoid their OID information travelling through hubs. Hubs may request OID information from clients. Clients may request OID information from hubs.
The requesting party MUST send an OID command with a service parameter only (no optional parameter). The responding party MAY answer with an OID command containing that same service parameter, and relevant optional parameters.
The responding party MAY send multiple OID commands in response to one request.
Any party MAY at any time send an OID response without any prior request.
Known services:
- DCBase: ID is the DCBase forum member numeric identifier.
- Facebook: ID is the public Facebook ID (that appears in a profile page's URL), NI (optional) is the friendly name.
- Google: EM is the Google email.
- LoL: SU is the League of Legends summoner name; SE is the server identifier, which MUST be one of "br", "eune", "euw", "kr", "na", "tr", "ru" that stand for, respectively, "Brazil", "EU Nordic & East", "EU West", "Korea", "North America", "Turkey", "Russia".
- MSLive: EM is the Microsoft Live email.
- PSN: ID is the PlayStation Network ID.
- Twitter: ID is the Twitter profile ID (that appears in a profile page's URL), NI (optional) is the nickname.
- Yahoo: EM is the Yahoo! email.
A new command is preferrable here over new INF fields to avoid clogging up its 2-letter identifiers. It also allows for more flexibility: multiple profiles of the same type; multiple identification parameters.
Parameters of the OID command:
- Unnamed parameter in first position to designate the service this command is referring to. Known services are listed in the "Known OID services" document. Before using a new service, make sure it isn't on that list and let ADC managers know about it.
- Optional named parameters whose meanings depend on the service in question.
OID commands support all contexts (hub-client, client-client). It is supported in the client-client context were users to want to avoid their OID information travelling through hubs. Hubs may request OID information from clients. Clients may request OID information from hubs.
The requesting party MUST send an OID command with a service parameter only (no optional parameter). The responding party MAY answer with an OID command containing that same service parameter, and relevant optional parameters.
The responding party MAY send multiple OID commands in response to one request.
Any party MAY at any time send an OID response without any prior request.
Known services:
- DCBase: ID is the DCBase forum member numeric identifier.
- Facebook: ID is the public Facebook ID (that appears in a profile page's URL), NI (optional) is the friendly name.
- Google: EM is the Google email.
- LoL: SU is the League of Legends summoner name; SE is the server identifier, which MUST be one of "br", "eune", "euw", "kr", "na", "tr", "ru" that stand for, respectively, "Brazil", "EU Nordic & East", "EU West", "Korea", "North America", "Turkey", "Russia".
- MSLive: EM is the Microsoft Live email.
- PSN: ID is the PlayStation Network ID.
- Twitter: ID is the Twitter profile ID (that appears in a profile page's URL), NI (optional) is the nickname.
- Yahoo: EM is the Yahoo! email.