我多久可以安全地缓存 baseUrl?

How frequently can I safely cache the baseUrl?

在每次请求 DocuSign REST API 之前,我都会调用 https://demo.docusign.net/restapi/v2/login_information。但是我需要从该响应中获得的唯一信息是第一个 baseUrl 属性,它似乎永远不会改变。如果它真的从不改变,我应该将值存储为常量,将我的请求数量减半。

假设我的集成密钥不变,baseUrl 多久(或在什么情况下)更改一次?更重要的是,我安全地缓存 baseUrl 的频率有多低?

由于是你无法控制的第三方API,我建议你每次都按照文档的要求进行调用。不知道他们什么时候会改变 API.

的内部结构

简答:谨慎缓存。它很可能永远不会改变,但如果改变了,只需再次抓住它。我会在一组请求的开头进行调用,然后忘记它。

baseUrl 参数如下所示: “https://demo.docusign.net/restapi/v2/accounts/123456

分解:

  • demo.docusign.net -> 我们的uri,demo环境如你所料, 演示站点。
  • restapi/v2/ -> 使用 api
  • 的版本 2
  • accounts/123456 -> 您的帐户 ID 特定于演示站点。 (这将是生产站点的不同 ID)

对于每个 api 调用,您都需要知道这个 url。为了安全起见,我不会将其存储 'forever',但您可以将其缓存一小段时间以减少 API 调用的次数。您的 accountId 永远不会在环境中改变,但我们偶尔会提供新的环境,每个不同的帐户都会有不同的 baseUrl。

供参考,请参见此处:https://docs.docusign.com/esign/guide/usage/quickstart.html

如果你真的想长期保存它,我会设置 30 天的超时时间或类似的东西。