设计考量

设置 zeuz 基础 API 的认证和使用认证凭证是一个多步骤的过程。了解所需任务的概要和详细步骤的链接,请参阅 API 认证概览

根据您想要实现的任务数量,您可以创建一个或多个脚本,来登录 zeuz、生成会话密钥、生成签名哈希并将签名哈希附到您的 API 请求中。

登录选项

关于登录 zeuz 和创建会话密钥的过程描述,请参阅 API 登录

会话密钥的有效期为 24 小时。下列选项概述了一些方法以及每种方法的利弊,您可以采取这些方法来规避该时限。

选项 1 - 每次调用 API 登录 zeuz

每次发送 API 请求登录 zeuz。

优点:

  • 确保您不会使用过期的会话 ID。
  • 最大限度地减少请求失败。
  • 不需要时间追踪,也不需要比较当前时间和签名哈希的失效时间。

缺点:

  • 拖慢了处理速度,因为每个 API 请求无论是否需要都会重新登录。

选项 2 - 每 24 小时登录 zeuz

每 24 小时登录 zeuz。

优点:

  • 确保您不会使用过期的会话 ID。
  • 最大限度地减少请求失败。

缺点:

  • 拖慢了处理速度,因为每个 API 请求无论是否需要都会重新登录。

选项 3 - 在发送 API 请求前检查登录的有效性

检查先前使用的登录会话是否有效。如果会话有效,则继续执行您的 API 请求。反之,如果会话无效,则重新登录。

优点:

  • 与其他选项相比,需要较少代码实现。
  • 在三个选项中,所需的处理最少。
  • 您可使用错误处理来管理失败的登录请求。

缺点:

  • 有意产生需要处理的登录失败。

推荐选项

[选项 3](#选项-3—在发送 API 请求前检查登录的有效性) 是多数情况下推荐的方法。关于根据自身需求改编代码的详情,请参阅下列文档:

关于 zeuz API 返回的错误代码,以及如何检查无效和过期的会话,请参阅 错误处理 页面。



2021年8月3日 该文档已更新并通过审校

2021年5月12日 该文档已创建并通过审校


最近更新时间: October 20, 2021 (af4b5d25)