如何通过AWS API密钥获取使用状态，避免Serverless API触发429限制

刚好我处理过类似的需求，给你几个实用的方案来解决这个问题——让用户能实时看到自己API密钥的剩余请求数，避免触发那讨厌的429超限错误：

1. 直接用API Gateway自带的响应头（最简单！） #

API Gateway在处理带API密钥的请求时，会自动在响应里添加几个关键的HTTP头，完全不需要额外开发：

• X-RateLimit-Limit: 你的使用计划配置的请求上限（比如每秒/每分钟允许的请求数）
• X-RateLimit-Remaining: 当前周期内还能用的剩余请求数
• X-RateLimit-Reset: 当前周期重置的时间戳（以秒为单位）

你只需要让前端读取这些响应头，就能实时展示用户的剩余额度，提前提醒他们不要超限。

2. 主动查询API密钥的使用情况 #

如果需要后台主动统计或者给用户提供查询接口，可以用AWS CLI或者SDK调用API Gateway的get-usage接口：

比如用AWS CLI执行这个命令（记得替换成你的实际ID）：

aws apigateway get-usage \
    --usage-plan-id YOUR_USAGE_PLAN_ID \
    --key-id YOUR_API_KEY_ID \
    --start-date 2024-01-01T00:00:00Z \
    --end-date 2024-01-02T00:00:00Z

这个命令会返回指定时间范围内该API密钥的请求使用数据，你可以把这些数据整合到自己的后台服务，再提供一个简单的查询接口给用户。

3. 在响应体里直接返回剩余请求数 #

如果你想把剩余请求数直接放在接口的响应体里（而不是让前端读响应头），可以在集成的Lambda函数中获取这些头信息，然后加到返回的JSON里。比如Node.js的Lambda示例：

exports.handler = async (event) => {
    // 从API Gateway的事件中拿到速率限制相关的头
    const rateLimitLimit = event.headers['X-RateLimit-Limit'];
    const rateLimitRemaining = event.headers['X-RateLimit-Remaining'];
    
    // 构造包含剩余请求数的响应
    const response = {
        statusCode: 200,
        body: JSON.stringify({
            result: "你的业务返回数据",
            remaining_requests: rateLimitRemaining,
            max_requests: rateLimitLimit
        }),
        headers: {
            'Content-Type': 'application/json',
            // 也可以保留原响应头，方便前端灵活读取
            'X-RateLimit-Limit': rateLimitLimit,
            'X-RateLimit-Remaining': rateLimitRemaining
        }
    };
    return response;
};

关于那个429错误的补充 #

你提到的这个错误就是典型的请求超限场景：

HTTP/2 429
content-type: application/json
content-length: 28
date: Mon, 16 Apr 2018 03:41:12 GMT
x-amzn-requestid: 02436b06-4128-11e8-aa37-8f617035a300
x-amzn-errortype: LimitExceededException
x-cache: Error from cloudfront
via: 1.1 de2aa82ec56d0a6d749df4bf0a88b28f.cloudfront.net (CloudFront)
x-amz-cf-id: afyULHDbLwJYAJO07zLeFG1Q0tZA-...

通过上面的方法提前告知用户剩余请求数，就能让他们及时调整请求频率，避免触发这个错误，提升用户体验。

内容的提问来源于stack exchange，提问作者hendry