Authentication
The Authentication web service allows you to log in with a user’s email address and password. The user may be a member of your account or your customer’s account. When a customers searches for resumes via the medium of an ATS (Application Tracking System), the caller is the ATS and the user belongs to customer’s account. A session token will be returned after a successful login, which must be sent along with a timestamp and a signature through HTTP custom headers (explained later) to verify authorization when calling other services. This session token expires after eight hours. If the user is a member of multiple accounts, the account must be specified in the login call, or the login will fail.
Security Tip: Use a Recruiter type user account that has permission to search for candidates. Please remember that you must have a resumé search license available in the user’s account for this service to work successfully.
HTTPS Method
POST
Parameters
| Field Name | Data Type | Valid Values | Max Length | Description |
|---|---|---|---|---|
| Login | String | Text | 225 | User’s email address. |
| Password | String | Text | 6-16 | User’s password. |
| Version | String | 3.0 | ||
| License Key | String | Text | 32 | Yahoo! HotJobs Web Service License Key. |
| ID | String | Text | 12 | Account ID. Required if the user is a member of multiple accounts. This ID can be obtained from YRC | Accounts Tab | Company Account | Account ID field. |

