API - 认证

身份验证是使用Lengow API的任何端点之前的第一步。每次连接都需要进行身份验证。

在此页面上,我们将描述您需要采取的步骤以确保您的应用程序可以对Lengow API进行身份验证。我们使用 Postman 进行示例和描述。
 

步骤1:客户端凭据

任何希望与Lengow API交互的合作伙伴都需要一组凭据 (一个Lengow帐户ID,一个 访问令牌 和一个clientSecret),可以通过Lengow仪表板找到。

在Lengow中找到这些API密钥的位置:

  • 登录您的Lengow帐户
  • 从您的个人资料> "一般信息"打开设置页面
  • 找到名为"A.P.I"的部分。  my.lengow.io/company/api 
  • 您可以复制在此部分显示的访问令牌  秘密  (参见下面的图片)

credentials.png

需要更新您的Lengow API密钥吗? 

要获取新的访问令牌和新的秘密,请阅读专门的FAQ:
💡 API - 如何更新我的Lengow API密钥?

如果您在您的端使用这些API密钥,请记住替换过时的密钥。

步骤2:获取访问令牌

接下来是从我们的身份验证服务获取访问令牌并在对Lengow API进行调用时将其设置为授权头

1.在Postman中设置您的身份验证环境

为了请求一个令牌,首先创建授权头。

  • 为此,使用Postman完成您的客户端凭据并创建您的环境。

2.请求访问令牌

设置授权头后,通过执行POST请求一个令牌:

POST /access/get_token

服务器返回这样的响应: 

{
"token": "1895caa9-94d3-4ff6-ac9a-5b74a0e5a1b7", 
"account_id": 1
}

3. 使用访问令牌完成身份验证环境 

再次在Postman中打开您的环境,并添加一个新的变量'"LENGOW_AUTH",并使用生成的令牌(参见图片 - 来源:Postman

auth_step2.png

注意: 如果凭据没有正确提供,您将收到服务器的401未授权响应。  

一旦您有了令牌,所有的API请求都需要一个活动的授权头(例如,使用您在Postman中创建的环境)。

这个令牌 您在每个新会话中生成的将需要任何请求 发送到API。每个令牌的生命周期为3600秒。  
不要为每个请求请求一个新的令牌 到Lengow API!令牌有效期较长,旨在重复使用。如果不这样做,可能会使身份验证服务过载,并在请求限制超过时导致IP封禁。请注意,身份验证服务的速率限制远低于Lengow API的速率限制。
Désolé, mais vous n'avez pas fourni de texte à traduire.
本文已自动翻译。如有疑问,请参阅英文或法文原文。

此组别内的文章

新闻、服务与事件报告
探索更新、网络研讨会和专家服务,助您充分利用 Lengow。