Tài liệu API

Cùng một nội dung, hai đường vào: REST cho script, MCP cho agent. Bài public đọc không cần key; guide subscriber cần API key của tài khoản có quyền.

Tổng quan

Mọi đường dẫn bên dưới tính từ địa chỉ gốc này. Phản hồi là JSON.

https://api.modernengineer.dev

Xác thực

Tạo API key trong Quản lý API key, rồi gửi kèm header Authorization: Bearer <key>. Key chỉ hiện một lần lúc tạo. Các verb public (catalog, articles) không cần key.

Hạn mức & lỗi

Mọi lỗi trả về cùng một dạng JSON, kèm requestId để báo lỗi:

{
  "error": {
    "code": "not_found",
    "message": "Content item was not found",
    "requestId": "…"
  }
}

Cài đặt MCP

Khai báo một lần trong client MCP, thay <API key> bằng key bạn đã tạo (file JSON không tự thay biến môi trường; client nào có cú pháp biến riêng thì dùng cú pháp đó). Dùng cùng API key với REST.

{
  "mcpServers": {
    "modernengineer": {
      "type": "http",
      "url": "https://api.modernengineer.dev/mcp",
      "headers": {
        "Authorization": "Bearer <API key>"
      }
    }
  }
}

Danh sách tool

Các verb dành cho agent đọc nội dung. Mỗi verb có một đường REST và một tool MCP cùng tham số. tools/list còn trả về vài tool quản lý tài khoản (API key, billing), không ghi ở đây.