收藏列表 API

目的

提取并列出所有已收藏员工的详细信息,例如员工记录编号、员工 ID 和邮箱地址。取消标记/移除收藏的员工 API - 从收藏列表中取消标记/移除员工。将员工标记为收藏 API - 将员工标记为收藏列表中的收藏项。

请求 URL

https://people.zoho.com.cn/people/api/employee/records/favorites?authtoken=<token>

请求参数

authtoken 指定身份验证令牌

示例

请求 URL:

https://people.zoho.com.cn/people/api/employee/records/favorites?authtoken=7d985878998943g4j09h43dd0b167dda34b

XML 响应:

<Response Status="1">
<Records>
<Record>
<Erecno>6000000026007</Erecno>
<EmployeeLastname>lokesh</EmployeeLastname>
<EmployeemailId>lokesh@zohosmtpin.india.adventnet.com</EmployeemailId>
<EmployeeFirstname>lokesh</EmployeeFirstname>
<Departmentname>Gadgets</Departmentname>
<ResidentialPhone>
</ResidentialPhone>
<workExtn>6543</workExtn>
<workPhone>3453</workPhone>
<mobile>9987898789</mobile>
<EmployeeId>4</EmployeeId>
</Record>
</Records>
</Response>

JSON 响应:

[{"Erecno":6000000026007,"EmployeeLastname":"lokesh","EmployeemailId":"lokesh@domain.com","EmployeeFirstname":"lokesh","Departmentname":"Support","ResidentialPhone":"","workExtn":"6543","workPhone":"3453","mobile":"9987898789","EmployeeId":"4"}]

取消标记/移除收藏的员工 API

用途:

您可随时从收藏列表中取消标记/移除员工。

请求 URL:

https://people.zoho.com.cn/people/api/employee/records/<recordId>?favStatus=false&authtoken=<token>

请求参数:

authtoken 指定身份验证令牌
recordid 指定待添加记录的用户记录 ID
favStatus 指定为 false 可取消标记

示例 URL:

https://people.zoho.com.cn/people/api/employee/records/6000000043063?favStatus=false&authtoken=7d985878998943g4j09h43dd0b167dda34b

XML 响应:

<Response Status="1">
<message>Successfully removed</message>
</Response>

JSON 响应:

[{"message":"Successfully removed","Response":1}]

将员工标记为收藏 API

用途:

收藏列表存放您收藏的所有员工的详细信息。只需将它们标记为收藏,即可在收藏列表下面查看它们。

请求 URL:

https://people.zoho.com.cn/people/api/employee/records/<recordId>?favStatus=true&authtoken=<token>

请求参数:

authtoken 指定身份验证令牌
recordId 指定待添加记录的用户记录 ID
favStatus 指定为 true 可将员工标记为收藏

示例 URL:

https://people.zoho.com.cn/people/api/employee/records/6000000043063?favStatus=true&authtoken=7d985878998943g4j09h43dd0b167dda34b

XML 响应:

<Response Status="1">
<message>Successfully added</message>
</Response>

JSON 格式:

[{"message":"Successfully added","Response":1}]

错误代码

请参阅错误代码