Zoho Recruit API 适用于 Zoho Recruit 的所有版本。若要使用 API,您将需要 Recruit 帐户的 Zoho Recruit 身份验证令牌。请确保您具有访问 API 服务的权限。如果您没有权限,请联系您的 Recruit 管理员。
生成身份验证令牌
要生成身份验证令牌,您需要使用以下 URL 格式将身份验证请求发送到 Zoho Accounts:
重要提示:
用户必须为已确认用户,否则在生成身份验证令牌时,用户将收到错误 - “ACCOUNT_REGISTRATION_NOT_CONFIRMED”。
URL 格式
API 模式:
https://accounts.zoho.com.cn/apiauthtoken/nb/create?SCOPE=ZohoRecruit/recruitapi&EMAIL_ID=Zoho Recruit Username or Email ID&PASSWORD=Your Zoho Recruit Password
使用双因素验证?
如果您使用双因素验证来访问您的 Zoho Recruit 帐户,请按照以下步骤在 API 模式中生成身份验证令牌:
- 登录至 Zoho Recruit。
- 打开 https://accounts.zoho.com.cn。
- 在 Zoho Accounts 主页,点击双因素验证。
- 在双因素验证 页面,点击管理应用程序特定密码。
- 在应用程序特定密码 弹出式窗口中,指定以下详细信息:
- 设备或应用名称
- 当前密码
- 点击生成。
您将收到带空格的新应用程序特定密码。
- 删除密码中的空格并将它附加在下面的 URL 中:
与此 URL 一起传递的参数为:
参数 | 描述 |
EMAIL_ID | 指定您的 Zoho Recruit 用户名或邮箱地址 |
作用域 | 将值指定为 ZohoRecruit/recruitapi |
密码 | 指定您的 Zoho Recruit 密码 |
有关更多信息,请参阅双因素验证帮助页面。
浏览器模式:
在新窗口中登录至 Zoho Recruit 并使用以下 URL:
https://accounts.zoho.com.cn/apiauthtoken/create?SCOPE=ZohoRecruit/recruitapi
如果您是 Google应用程序用户,则您可以登录 Recruit 帐户,然后使用浏览器模式格式来生成身份验证令牌。
示例响应
#
#Wed Feb 29 03:07:33 PST 2012
AUTHTOKEN=bad18eba1ff45jk7858b8ae88a77fa30
RESULT=TRUE
- 身份验证令牌可在所有 API 调用中使用。您也可以在设置 > 开发者空间 > Recruit API 下面查看 URL 格式。
- 您需要登录至 Recruit 帐户以使用浏览器模式。
示例
下面是获取记录的示例:
管理身份验证令牌
您可以从‘我的 Zoho 帐户’页面查看、删除和重新生成为您的帐户生成的身份验证令牌。
- 登录至 Zoho Recruit。
- 打开[用户名] > 我的 Zoho 帐户。
- 在我的 Zoho 帐户 页面,点击设置 > 活动授权标记。
在此页面中,您也可以删除或重新生成身份验证令牌。
注:
- 删除身份验证令牌将永久删除令牌。
- 如果您重新生成身份验证令牌,请使用新令牌更新您的程序。
重要提示
- 身份验证令牌特定于用户,是一个永久令牌。
- 在删除时,现有令牌将永久删除。必须为所有 API 调用替换新令牌。
- 如果用户已被禁用,则用户帐户的身份验证令牌将变成无效。