changeStatus 方法
目的
您可以使用此方法更改 Zoho Recruit 中的应聘者空缺职位状态。
重要事项:使用 POST 方法而不是 GET 方法来传递这些参数。
请求 URL
XML 格式
https://recruit.zoho.com.cn/recruit/private/xml/Candidates/changeStatus?authtoken=Auth Token&scope=recruitapi
JSON 格式
https://recruit.zoho.com.cn/recruit/private/json/Candidates/changeStatus?authtoken=Auth Token&scope=recruitapi
请求参数
参数 | 数据类型 | 描述 |
authtoken* | 字符串 | 加密的字母数字字符串,用来对 Zoho 凭证进行身份验证。 |
scope* | 字符串 | 将值指定为 recruitapi。 |
jobId | 字符串 | 指定必须更改其关联应聘者状态的“空缺职位”记录的 uniqueID。 |
candidateIds* | 字符串 | 指定必须更改其空缺职位状态的应聘者 ID(用英文逗号分隔)。 |
version* | 整数 | 使用 version=2:这将基于最新 API 实施来提取响应 |
candidateStatus* | 字符串 | 针对空缺职位,指定应聘者的状态。 |
comments | 字符串 | 指定状态更改的注释。 |
* - 必备参数
示例
针对空缺职位,更改应聘者的状态。
URL 格式:
https://recruit.zoho.com.cn/recruit/private/xml/Candidates/changeStatus?authtoken=Auth Token&scope=recruitapi&jobId=54290000000089027&candidateIds= 54290000000022332,54290000000089027&candidateStatus=Hired&comments=Placed in Java Development
响应格式:
<response uri="/recruit/private/xml/Candidates/changeStatus">
<result>
<message>Candidate(s) status changed successfully</message>
<recorddetail>
<FL val="jobId"> 292114000000087156</FL>
<FL val="candidateStatus">Hired</FL><FL val="comments"> Placed in Java Development</FL>
</recorddetail>
</result>
</response>