API

API 文档

用户 ID 与 API Key

用户由管理员创建。使用五位用户 ID 和登录密码进入账户页，再次验证密码可查看完整 API Key。旧版哈希密钥需先由管理员重置。重置或撤销密钥后旧密钥立即失效，暂不开放自行注册、取号或扣款。

GET https://beansms.app/api/v1/account
Authorization: Bearer YOUR_API_KEY

{
  "userId": 10000,
  "label": "customer-reference",
  "scopes": ["account:read"]
}

401 INVALID_API_KEY
503 STORAGE_UNAVAILABLE

示例不代表真实账户。密钥仅供服务端使用，请勿放入网址、公开代码或浏览器前端。请通过 HTTPS 请求；泄露时立即联系管理员重置。

库存价格接口为公开只读接口，不提供取号或扣款。

GET /api/health
GET /api/prices?service=kt

售价 / 库存

{
  "service": "kt",
  "currency": "USD",
  "priceType": "sale",
  "updatedAt": "2026-10-20T12:00:00.000Z",
  "expiresAt": "2026-10-20T13:00:00.000Z",
  "stale": false,
  "syncFailed": false,
  "rows": [
    {
      "country": "12", "currency": "USD", "cost": "0.144", "stock": 20,
      "tiers": [
        { "currency": "USD", "cost": "0.144", "stock": 20, "stale": false },
        { "currency": "USD", "cost": "0.24", "stock": 35, "stale": false }
      ]
    }
  ],
  "sources": [
    { "provider": "smsbower", "ready": true,
      "updatedAt": "2026-10-20T12:00:00.000Z", "stale": false, "syncFailed": false },
    { "provider": "hero-sms", "ready": true,
      "updatedAt": "2026-10-20T12:00:00.000Z", "stale": false, "syncFailed": false }
  ]
}

格式示例，不代表实际报价。币种以上游账户配置为准。

库存价格已过期，仅供参考。

400 INVALID_SERVICE
503 PRICES_NOT_READY
503 STORAGE_UNAVAILABLE