算力舱手册

Appearance

API ​

本文档整理 LC-X3 相关的后端接口。

判断当前是否有算力舱 ​

GET /backend/device/hasDefault ​

用途：

  • 判断当前微服下是否存在一个可用的默认算力舱
  • 可用于 AI 应用启动前预检，或页面加载时判断是否需要引导用户先添加算力舱

请求：

  • Method: GET
  • 路径：/backend/device/hasDefault
  • 完整地址示例：https://ai.<box-domain>/backend/device/hasDefault
  • 无需请求体

返回：

  • 200 OK：当前存在可用的默认算力舱
  • 503 Service Unavailable：当前没有可用的默认算力舱

说明：

  • 该接口不返回 JSON，直接通过 HTTP 状态码表达结果
  • 后端会先查找默认算力舱；如果当前还没有显式默认值，会自动从已授权设备中挑选一台活跃设备作为默认算力舱
  • 即使存在默认算力舱，如果该设备超过 1 分钟没有活跃心跳，也会返回 503

示例：

bash
curl -i "https://ai.<box-domain>/backend/device/hasDefault"

返回 200 时示例：

http
HTTP/1.1 200 OK

返回 503 时示例：

http
HTTP/1.1 503 Service Unavailable