content.search
GET/content/search
Tìm trong mọi bài đã đăng của một ngôn ngữ, không phân biệt dấu. Mỗi bài một kết quả, khớp nhất trước, kèm tên mục khớp. Không cần key. Bài bạn được đọc khớp theo tiêu đề, tóm tắt, tag, tên mục và toàn văn, kèm đoạn trích tối đa 400 ký tự; bài khác chỉ khớp theo những gì danh mục đã hiện (tiêu đề, tóm tắt, tag, tên mục và phần mở đầu), bị khoá, và phản hồi có thêm gợi ý nâng cấp.
Tham số
| Tham số | Vị trí | Mô tả |
|---|---|---|
locale | query | Bắt buộc. vi hoặc en. |
q | query | Bắt buộc. Từ khoá, 1 đến 200 ký tự. |
limit | query | Không bắt buộc. Số kết quả, 1 đến 20, mặc định 8. |
Yêu cầu
curl "https://api.modernengineer.dev/content/search?locale=vi&q=fallback"Phản hồi
{
"items": [
{
"access": "subscriber",
"kind": "guide",
"locale": "vi",
"locked": true,
"route": "/vi/library/omp-model-routing-guide",
"section": "Vai trò chỉ là bí danh, fallback là một lớp khác",
"slug": "omp-model-routing-guide",
"title": "Định tuyến model trong Oh-my-pi (OMP): vai trò, fallback và cách biết model nào đang chạy"
}
],
"upgrade": {
"message": "Kết quả bị khoá dành cho người đăng ký. Đăng ký để đọc đoạn trích và toàn văn bằng content_get.",
"url": "/vi/pricing"
}
}Lỗi
| Mã | Lỗi | Khi nào |
|---|---|---|
| 403 | forbidden | Thiếu key, hoặc key không thuộc tài khoản đã đăng ký. |
| 400 | invalid_input | Tham số thiếu hoặc sai, ví dụ locale khác vi và en. |
| 429 | too_many_requests | Kết quả có đoạn trích và tài khoản đã quá 1.000 lần đọc trong 24 giờ, tính chung với content.get. |