Status API 文档

程序化访问 poeti.ai 系统状态和健康信息

API Base URL

https://status.poeti.ai/api/v1
All Systems Operational
GET /status
获取系统整体状态

响应示例

{
  "status": "operational",
  "updated_at": "2026-03-25T10:30:00Z",
  "services": {
    "api": "operational",
    "dashboard": "operational",
    "billing": "operational",
    "monitoring": "operational"
  },
  "providers": {
    "openai": "operational",
    "anthropic": "operational",
    "google": "operational",
    "aws_bedrock": "operational",
    "cohere": "operational",
    "mistral": "operational",
    "grok": "operational",
    "deepseek": "operational",
    "openrouter": "operational"
  },
  "uptime": {
    "last_24h": 99.98,
    "last_7d": 99.95,
    "last_30d": 99.92
  }
}
GET /status/components
获取所有组件状态

响应示例

{
  "components": [
    {
      "id": "api",
      "name": "API Gateway",
      "status": "operational",
      "updated_at": "2026-03-25T10:30:00Z",
      "response_time_ms": 45,
      "uptime_percentage": 99.98
    },
    {
      "id": "dashboard",
      "name": "Dashboard",
      "status": "operational",
      "updated_at": "2026-03-25T10:30:00Z",
      "response_time_ms": 120,
      "uptime_percentage": 99.95
    },
    {
      "id": "billing",
      "name": "Billing Service",
      "status": "operational",
      "updated_at": "2026-03-25T10:30:00Z",
      "response_time_ms": 80,
      "uptime_percentage": 99.99
    }
  ]
}
GET /status/providers/:provider
获取特定提供商状态

请求示例

GET /status/providers/openai

响应示例

{
  "provider": "openai",
  "name": "OpenAI",
  "status": "operational",
  "updated_at": "2026-03-25T10:30:00Z",
  "latency": {
    "avg_ms": 350,
    "p50_ms": 280,
    "p95_ms": 650,
    "p99_ms": 1200
  },
  "availability": {
    "last_24h": 99.95,
    "last_7d": 99.92,
    "last_30d": 99.88
  },
  "models": [
    {
      "model": "gpt-4-turbo",
      "status": "operational",
      "latency_ms": 320
    },
    {
      "model": "gpt-3.5-turbo",
      "status": "operational",
      "latency_ms": 180
    }
  ]
}
GET /status/incidents
获取历史事件

查询参数

  • limit - 返回数量，默认 20，最大 100
  • status - 筛选状态：investigating, identified, monitoring, resolved
  • since - 起始时间（ISO 8601 格式）

响应示例

{
  "incidents": [
    {
      "id": "INC-2026-001",
      "title": "API Gateway 部分请求延迟增加",
      "status": "resolved",
      "severity": "minor",
      "started_at": "2026-03-20T14:30:00Z",
      "resolved_at": "2026-03-20T15:45:00Z",
      "affected_components": ["api"],
      "updates": [
        {
          "status": "investigating",
          "message": "我们正在调查 API 延迟增加的原因",
          "created_at": "2026-03-20T14:35:00Z"
        },
        {
          "status": "identified",
          "message": "问题已定位到数据库连接池配置",
          "created_at": "2026-03-20T15:00:00Z"
        },
        {
          "status": "resolved",
          "message": "问题已解决，服务恢复正常",
          "created_at": "2026-03-20T15:45:00Z"
        }
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}
GET /status/metrics
获取性能指标

响应示例

{
  "metrics": {
    "request_rate": {
      "current": 1250,
      "unit": "requests/second"
    },
    "response_time": {
      "avg_ms": 85,
      "p50_ms": 65,
      "p95_ms": 180,
      "p99_ms": 320
    },
    "error_rate": {
      "percentage": 0.12,
      "count": 45
    },
    "success_rate": {
      "percentage": 99.88
    }
  },
  "timestamp": "2026-03-25T10:30:00Z"
}

状态码说明

系统状态

  • operational - 正常运行
  • degraded_performance - 性能下降
  • partial_outage - 部分故障
  • major_outage - 重大故障
  • under_maintenance - 维护中

事件严重程度

  • minor - 轻微影响
  • moderate - 中等影响
  • major - 重大影响
  • critical - 严重影响

速率限制

Status API 对所有用户开放，无需认证，但有以下速率限制：

  • • 每 IP 地址：100 请求/分钟
  • • 超过限制返回 429 Too Many Requests
  • • 响应头包含 X-RateLimit-Limit 和 X-RateLimit-Remaining

Webhook 订阅

订阅状态更新 webhook，在系统状态变化时接收实时通知。

💡 提示：Webhook 配置需要登录到控制台 → 设置 → 通知

使用示例

cURL

curl -X GET https://status.poeti.ai/api/v1/status \
  -H "Accept: application/json"

Python

import requests

response = requests.get('https://status.poeti.ai/api/v1/status')
data = response.json()
print(f"System status: {data['status']}")

JavaScript

fetch('https://status.poeti.ai/api/v1/status')
  .then(response => response.json())
  .then(data => {
    console.log('System status:', data.status);
  });