API令牌信息

获取当前Twitter API令牌的使用情况，包括剩余请求配额和重置时间。

请求

URL: /api/twitter/token-info

方法: GET 或 POST

请求参数:

无特定参数要求，只需提供API密钥进行认证。

响应

成功响应会返回当前API令牌的使用情况，包括剩余请求数量、配额上限、重置时间等信息。

示例

请求示例

# GET 请求
curl --request GET \
  --url 'https://www.aidir.fun/api/twitter/token-info' \
  --header 'X-API-Key: <api-key>'
 
# POST 请求
curl --request POST \
  --url 'https://www.aidir.fun/api/twitter/token-info' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>'

响应示例

{
  "data": {
    "token_type": "bearer",
    "app_limit": 1500,
    "remaining": 1375,
    "reset_at": "2023-04-15T15:00:00.000Z",
    "account": {
      "app_id": "12345",
      "app_name": "My Twitter App",
      "organization": "My Organization"
    },
    "request_history": [
      {
        "endpoint": "/user-profile",
        "timestamp": "2023-04-15T14:34:12.000Z",
        "status": "success"
      },
      {
        "endpoint": "/user-tweets",
        "timestamp": "2023-04-15T14:30:05.000Z",
        "status": "success"
      }
    ]
  }
}

错误响应

状态码	描述
401	认证失败，API密钥无效或缺失
500	服务器内部错误

使用场景

使用此API可以：

监控API使用情况：了解当前API使用情况，避免超出配额限制
优化请求策略：根据剩余配额数量调整请求频率
调试问题：在API请求失败时，检查是否因为达到速率限制

注意事项

API配额通常基于滑动时间窗口计算，具体限制取决于您的Twitter API订阅等级
超出配额限制可能导致请求被临时封锁
此API不消耗Twitter API的请求配额，可以频繁调用以监控使用情况

API令牌信息

目录