身份验证令牌

目录

目的

要使用 Zoho People API，需要从您的 Zoho People 帐户获取 Zoho People 身份验证令牌。

身份验证令牌生成

身份验证令牌可通过两种方法来生成：浏览器模式和 API 模式：

浏览器模式

请求 URL：

https://accounts.zoho.com.cn/apiauthtoken/create?SCOPE=zohopeople/peopleapi

示例响应：

#Tue Nov 30 13:08:11 PST 2010 AUTHTOKEN=a8b6de25b5bf481824c9c4173c56231a RESULT=TRUE

键值描述：

键值 描述
#Comment Authtoken 生成日期。
AUTHTOKEN 为 Zoho People API 访问生成的永久身份验证令牌。
RESULT 如果 authtoken 成功生成，则值为 TRUE。

API 模式

请求 URL：

https://accounts.zoho.com.cn/apiauthtoken/nb/create

POST 主体应包括以下格式的字符串

?SCOPE=Zohopeople/peopleapi&EMAIL_ID=Zoho People Username or Email ID&PASSWORD=Your Zoho People Password

需要在 URL 中传递的必填字段：

SCOPE Zohopeople/peopleapi
EMAIL_ID 您的 Zoho 登录名或邮箱地址
PASSWORD Zoho ID 的密码

示例响应：

#Tue Nov 30 02:16:57 PST 2010
AUTHTOKEN=e07119171812c29b3a0dacdb79a57e3f
RESULT=TRUE

键值描述

键值 描述
#Comment Authtoken 生成日期。
AUTHTOKEN 为请求生成的身份验证令牌。
RESULT 如果 authtoken 成功生成，则值为 TRUE。

示例

下面是调用身份验证令牌的示例 API

https://people.zoho.com.cn/people/api/forms/P_EmployeeView/records?authtoken=7d985878998943g4j09h43dd0b167dda34b

注：

  • 在这里，P_EmployeeView 是视图名称。

管理身份验证令牌

您可以通过查看、删除和重新生成功能来管理身份验证令牌。

  1. 登录至 Zoho People。
  2. 单击我的帐户 > 活跃的 Authtoken。
  3. 在设置页面，您可查看、删除和重新生成身份验证令牌。

重要提示

  • 身份验证令牌是用户特定的，且其寿命是永久的。
  • 如果使用了删除功能，现有令牌将被永久删除。使用重新生成功能在所有 Zoho People API 调用中替换为新令牌。
  • 如果用户已被禁止登录，则该用户帐户的身份验证令牌将失效。
  • 在 URL 中传递的参数名称应区分大小写。
  • 如果在生成身份验证令牌时遇到任何难题，请联系 support@zohocorp.com.cn。