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

catalog.list

GET/catalog

Liệt kê metadata mọi bài đã đăng (cả bài public lẫn bài cho subscriber) của một ngôn ngữ. Không cần key.

Tham số

Tham sốVị tríMô tả
localequeryBắ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/catalog?locale=vi&limit=20"

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": 164,
  "nextOffset": 20
}

Lỗi

MãLỗiKhi nào
400invalid_inputTham số thiếu hoặc sai, ví dụ locale khác vi và en.

Trong MCP