Welcome, guest Sign In

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

Table 1. 
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.

Request XML Sample

Success Response XML Sample

Error Response XML Sample

Table of Contents

Copyright © 2009 Yahoo! Inc. All rights reserved. Copyright | Privacy Policy

Help us continue to improve the Yahoo! Developer Network: Send Your Suggestions