Authentication

Revised: June 17, 2019

1.0 Get a daily 24-Hour Security Token for M's within the IKEY

Operational






Test URL:

https://secure.e-registernow.com/cgi-bin/accept.cgi?IKEY=PATRICK&U_LOGIN=API&U_PASSWORD=APItest1%21&U_PIN=&FORMATSTYLE=JSON &apiButton=POST&state=GETSECURETOKENIKEY

URL Breakdown
  • IKEY is the ignition key associated with the M accounts.
  • U_LOGIN is your e-RegisterNow login name.
  • U_Password is the password you use to login to e-RegisterNow with. A pin(U_PIN) may be set here.
  • FORMATSTYLE(JSON or Tab Delimited) is the format you want the return to be in.
About Call:
  • This call issues a daily security token.
  • A daily security token is necessary for most calls in the API to work.
  • Security tokens are valid for 24 hours from the time of issue. (times based on Toronto, ET)
  • Changing the Pin If a password and pin are simultaneously entered, the pin value will be changed to the value entered if and only if the password is valid.
  • To authenticate, and hence obtain a token, you must specify correctly a "Login" and either a "Password" or a "Pin".
  • The IKEY defines the realm of M-accounts which will be accessed.
Errors:
  • Error T104: secure token unavailable: data that was input is not valid or missing.

1.1 Get a daily 24-Hour Security Token for a specific M-account


Operational







Test URL:

https://secure.e-registernow.com/cgi-bin/accept.cgi?MID=123&U_LOGIN=API&U_PASSWORD=APItest1!&U_PIN=&FORMATSTYLE=JSON&apiButton=POST&state=GETSECURETOKENMID

URL Breakdown
  • MID is the account number for the M account you want a Security Token for.
  • U_LOGIN is your e-RegisterNow login name.
  • U_Password is the password you use to login to e-RegisterNow with. A pin(U_PIN) may be set here.
  • FORMATSTYLE(JSON or Tab Delimited) is the format you want the return to be in.
About Call:
  • This call issues a daily security token.
  • Security tokens are valid for 24 hours from the time of issue. (times based on Toronto, ET)
  • Changing the Pin If a password and pin are simultaneously entered, the pin value will be changed to the value entered if and only if the password is valid.
  • To authenticate, and hence obtain a token, you must specify correctly a "Login" and either a "Password" or a "Pin".
Errors:
  • Error M104: secure token unavailable: data that was input is not valid or missing.

1.2 Get a daily 24-Hour Security Token for a specific C-account


Operational







Test URL:

https://secure.e-registernow.com/cgi-bin/accept.cgi?CID=82&U_LOGIN=API&U_PASSWORD=APItest1%21&U_PIN=&FORMATSTYLE=JSON&apiButton=POST&state=GETSECURETOKENCID

URL Breakdown
  • CID is the account number for the C account you want a Security Token for.
  • U_LOGIN is your e-RegisterNow login name.
  • U_Password is the password you use to login to e-RegisterNow with. A pin(U_PIN) may be set here.
  • FORMATSTYLE(JSON or Tab Delimited) is the format you want the return to be in.
About Call:
  • This call issues a daily security token.
  • The response from the eRegisterNow server returns JSON or TAB delimited.
  • A daily security token is necessary for each call below to operate.
  • Security tokens are valid for 24 hours from the time of issue. (times based on Toronto, ET)
  • Changing the Pin If a password and pin are simultaneously entered, the pin value will be changed to the value entered if and only if the password is valid.
  • To authenticate, and hence obtain a token, you must specify correctly a "Login" and either a "Password" or a "Pin".
  • If access is granted, then the token will work on all enabled M-accounts within the C-account.
Errors:
  • Error C104: secure token unavailable: data that was input is not valid or missing.