Bỏ qua điều hướng
EN
REST › content.list

content.list

GET/content

Liệt kê metadata các bài cho subscriber, article lẫn guide. Cần key của một tài khoản đã đăng ký; chưa cần quyền subscriber.

Tham số

Tham sốVị tríMô tả
localequeryKhông bắt buộc. vi hoặc en.
qqueryKhông bắt buộc. Tìm trong tiêu đề, tóm tắt, slug, tag và tên mục. Không phân biệt hoa thường hay dấu.
topicqueryKhông bắt buộc. Mảng: workflow, harness, agents, tools, repos, patterns hoặc system-design.
blogCategoryqueryKhông bắt buộc. Mục trong thư viện: article, deep-dive, tutorial hoặc series.
kindqueryKhông bắt buộc. article (bài viết) hoặc guide (hướng dẫn từng bước). Kind không quyết định quyền đọc: cả hai đều có thể public hoặc cho subscriber.
seriesqueryKhông bắt buộc. Slug của series, ví dụ inside-omp. Kết quả xếp theo thứ tự trong series.
akKitqueryKhông bắt buộc. Kit AgentKit chứa skill của guide: core (có trong mọi kit), engineer hoặc marketing. Chỉ guide skill AgentKit có trường này.
limitqueryKhông bắt buộc. Số bài mỗi trang, 1 đến 100. Bỏ trống thì trả về toàn bộ danh sách.
offsetqueryKhông bắt buộc. Bỏ qua bao nhiêu bài đầu, mặc định 0. Trang sau dùng nextOffset của phản hồi; trang cuối không có nextOffset.

Yêu cầu

curl
curl "https://api.modernengineer.dev/content?locale=vi" \
  -H "Authorization: Bearer $SE_KEY"

Phản hồi

200 OK · application/json
{
  "items": [
    {
      "access": "subscriber",
      "alternate": "/en/library/omp-model-routing-guide",
      "blogCategory": "series",
      "canonical": "/vi/library/omp-model-routing-guide",
      "category": "facebook_subscriber",
      "created": "2026-08-26",
      "kind": "guide",
      "license": "Subscriber-only; redistribution prohibited",
      "locale": "vi",
      "readingMinutes": 19,
      "rightsOwner": "Thieu Nguyen",
      "route": "/vi/library/omp-model-routing-guide",
      "sections": [
        "1. Chuỗi định tuyến",
        "2. Nhà cung cấp xuất hiện trong bài",
        "3. Role hoạt động và được trigger ra sao?",
        "…"
      ],
      "sha256": "29537d02…",
      "slug": "omp-model-routing-guide",
      "summary": "Role OMP là alias định tuyến, không phải agent. Gán model theo workload, kiểm tra effective state, và fallback khi lỗi.",
      "tags": [
        "oh-my-pi",
        "models",
        "routing",
        "advisor"
      ],
      "title": "Định tuyến model trong OMP: role, fallback và cấu hình thực tế",
      "topic": "harness",
      "updated": "2026-08-30",
      "version": "1.0.0",
      "visual": {
        "contentType": "text/html; charset=utf-8",
        "key": "visuals/omp-model-routing-guide/d6c28f8f….html"
      }
    }
  ],
  "total": 1
}

Lỗi

MãLỗiKhi nào
403forbiddenThiếu key, hoặc key không thuộc tài khoản đã đăng ký.
400invalid_inputTham số thiếu hoặc sai, ví dụ locale khác vi và en.

Trong MCP