开发者中心

REST API

通过 Monio Open API 读取设备卡片，更新文本、图片、自定义内容与 AI 使用额度。所有接口均需 API Key 鉴权，并返回 JSON。

Base URL
https://open.monio.cn
鉴权
Bearer Token / X-API-Key

可使用 Authorization: Bearer <API_KEY> 或 X-API-Key: <API_KEY>。HTTP 状态码统一为 200，请以响应体中的 code 判断业务是否成功。

管理 API 密钥
在「用户中心 · API 密钥」中创建、查看与吊销你的访问密钥
前往设置
GET/v1/device/card/list

获取当前 API Key 用户指定设备下的可用卡片，按卡片排序值和 ID 升序返回。

请求参数

参数位置类型必填说明
device_codeQuerystring必填设备编码，对应 i_user_devices.device_code

查询规则

  • 设备必须属于当前 API Key 对应用户，且设备状态必须为 1。
  • 卡片与卡片模板的状态都必须为 1。
  • 结果按 i_user_cards.sort ASC、id ASC 排序。

常见错误

  • 缺少参数 device_code
  • 设备不存在或不可用
  • 获取设备卡片列表失败

格式错误时，message 会在主错误文案后附带具体原因。

在线调试

请求直接从浏览器发往 https://open.monio.cn，密钥只保存在本地
Authorization
Bearer
GEThttps://open.monio.cn/v1/device/card/list?device_code=hhh23

当前请求的代码

request.sh
curl "https://open.monio.cn/v1/device/card/list?device_code=hhh23" \
  -H "Authorization: Bearer $MONIO_TOKEN"

响应示例

200 OK · code 0·示例
response.json
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "uuid": "1f56d44e-a591-4236-a3d8-122e44c4b032",
      "card_name": "自定义文本API"
    }
  ]
}