Cisco Jasper 已经建立了一项 API 公平使用策略，确保所有 Control Center 用户都可以获得最佳的体验。任何使用 Control Center API 的客户端代码都必须遵守下述限制规定。

并发连接

Cisco Jasper 建议企业避免进行并发处理，因为它可能会显著降低响应速度。我们建议仅在单线程应用程序或例程中使用 API。在多线程情况下使用 API 的账户可能会受到限流或其他限制，具体视环境而定。

策略： 使用单线程代码 - 一次一项 API 调用。

每秒调用数

Cisco Jasper 通过限制账户每秒可以进行的 API 调用数来确保可靠的 API 性能。如果您的账户超出限制，则在测量期间(一秒)内的后续 API 调用将根据 API 类型获得下表中显示的响应。经过适当的延迟后，程序应该重试 API 调用。

最佳做法

以下技巧可帮助您避免 API 使用过量时可能发生的限流或其他用量限制。

添加速率限制代码

避免超过每秒调用数限制的最佳做法便是创建单线程代码。但是，您可能会遇到无法避免的情况。例如：

• 多个 API 用户都在进行调用。
• 您需要同时使用 REST 和 SOAP 函数。
• 您有大量需要多线程进程的调用。

在这些情况下，建议创建速率限制例程，用于监控和调节您的 API 调用。例如，如果账户在处理调用时收到多个错误消息，您可以在 API 调用之间引入一个等待时间。您可以增加这个等待时间，直到错误不再出现。

虚拟代码示例。以下虚拟代码将演示速率限制代码的作用方式。

// DISCLAIMER: THIS EXAMPLE IS PROVIDED FOR ILLUSTRATION PURPOSES ONLY, 
// AND WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED

WHILE ( <<list is not empty>> )
{
    // API_call attempts to perform an action to update the DEVICE status
    // it returns the API response code
    response = API_call( <<list element>> )
                                 
    // API call returns the "limit exceeded" error, increase loop delay
    IF ( response == ERROR_LIMIT_EXCEEDED )
    {
        delay += ADJUST_DELAY_INCR
    } 
    ELSE 
    {   // ensure delay never goes below 0
        IF ( delay > ADJUST_DELAY_DECR )
	 {
	     delay -= ADJUST_DELAY_DECR
	 }
	 ELSE
	 {
	     delay = 0
	 }			
    }

    sleep( delay )
}

调整调用频率

通过 API 跟踪设备用量时，必须将您的 API 调用频率与运营商的更新频率保持一致。

例如，如果您的运营商每 6 小时更新一次用量信息，则通过 API 请求信息的频率不能超过每 6 小时一次。此外，用量数据可用的时间与 Control Center 从运营商接收到该用量数据的时间之间通常会有延迟。有时，延迟可能长达 24 小时。

使用筛选器限制 API 调用

在执行程序前通过检查特定条件来避免不必要的 API 调用。例如：

• 如果设备已停用，请勿检查用量。
• 如果客户未请求设备用量，请勿每小时检查一次。

延长搜索之间的间隔时间

如果收到为空或者未改变的 API 响应，请延长查询间隔。例如，考虑将查询从每两个小时一次更改为一天一次。