Tìm kiếm tài liệu
Tìm trong các tài liệu đã xuất bản theo từ khoá (tìm toàn văn tiếng Việt, không phân biệt dấu) và bộ lọc. Bỏ trống q để duyệt toàn bộ danh mục. Mỗi bộ lọc nhận nhiều giá trị ngăn bằng dấu phẩy (tối đa 20): tài liệu khớp MỘT trong các giá trị của bộ lọc và phải khớp MỌI bộ lọc được truyền. Tìm kiếm xét tối đa 500 kết quả phù hợp nhất.
Tham số
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
| qtuỳ chọn | query | chuỗitối đa 300 ký tự | Từ khoá tìm kiếm. |
| sorttuỳ chọn | query | một trongrelevancenewestdownloads | Thứ tự: relevance độ phù hợp (không có q thì theo lượt xem), newest mới nhất, downloads tải nhiều nhất.Mặc định: relevance |
| pagetuỳ chọn | query | số nguyêntừ 1 đến 100000 | Trang cần lấy, bắt đầu từ 1.Mặc định: 1 |
| perPagetuỳ chọn | query | số nguyêntừ 1 đến 50 | Số mục mỗi trang (tối đa 50).Mặc định: 20 |
| categorytuỳ chọn | query | danh sách ngăn bằng dấu phẩyGiáo trìnhĐề thiEbookNghiên cứuHSKIELTSWordPressAILập trình | Chủ đề / lĩnh vực. |
| workTypetuỳ chọn | query | danh sách ngăn bằng dấu phẩydocumentbookarticlecoursethesis | Loại công trình. |
| fileTypetuỳ chọn | query | danh sách ngăn bằng dấu phẩyPDFDOCPPTXLS | Định dạng tệp. |
| languagetuỳ chọn | query | danh sách ngăn bằng dấu phẩyvienzh | Ngôn ngữ: vi tiếng Việt, en tiếng Anh, zh tiếng Trung. |
| audiencetuỳ chọn | query | danh sách ngăn bằng dấu phẩystudentgraduatephdlecturerresearcherbusinessgeneral | Đối tượng sử dụng. |
| authortuỳ chọn | query | danh sách ngăn bằng dấu phẩy | Tên tác giả, khớp chính xác. |
| publishertuỳ chọn | query | danh sách ngăn bằng dấu phẩy | Đơn vị xuất bản / cung cấp, khớp chính xác. |
| tagtuỳ chọn | query | danh sách ngăn bằng dấu phẩy | Từ khoá gắn với tài liệu, khớp chính xác. |
| pricetuỳ chọn | query | một trongfreepaid | Chỉ tài liệu miễn phí hoặc chỉ tài liệu trả phí. |
| accesstuỳ chọn | query | một trongopenrestricted | Mức truy cập của tài liệu. |
| yearFromtuỳ chọn | query | số nguyêntừ 1000 đến 3000 | Năm xuất bản từ (tính cả năm này). |
| yearTotuỳ chọn | query | số nguyêntừ 1000 đến 3000 | Năm xuất bản đến (tính cả năm này). |
Ví dụ gọi
curl "https://knowledge.asyncs.tech/api/v1/documents?q=marketing&perPage=5" \
-H "Authorization: Bearer $KNOWLEDGE_API_KEY"Ví dụ kết quả
{
"data": [
{
"id": "d-1",
"slug": "marketing-can-ban",
"url": "https://knowledge.asyncs.tech/documents/marketing-can-ban",
"title": "Marketing căn bản",
"description": "Giáo trình nhập môn marketing dành cho sinh viên khối ngành kinh tế.",
"workType": "document",
"fileType": "PDF",
"category": "Giáo trình",
"language": "Tiếng Việt",
"pages": 248,
"year": 2024,
"tags": [
"marketing",
"kinh tế"
],
"publisher": "NXB Đại học Kinh tế Quốc dân",
"audience": [
"student"
],
"accessLevel": "open",
"priceVnd": 0,
"authors": [
{
"name": "Nguyễn Văn A",
"slug": "nguyen-van-a"
}
],
"summary": "Trình bày các khái niệm nền tảng của marketing: thị trường, phân khúc, định vị và 4P.",
"stats": {
"views": 12840,
"downloads": 3210,
"rating": 4.6,
"ratingCount": 87
},
"publishedAt": "2026-09-12T03:15:00.000Z"
}
],
"pagination": {
"page": 1,
"perPage": 5,
"total": 1,
"pageCount": 1
}
}Lỗi có thể gặp
- 400
invalid_requestTham số không hợp lệ.messagenêu tên tham số sai. - 401
unauthorizedThiếu khoá API, khoá sai, đã bị thu hồi hoặc đã hết hạn. - 429
rate_limitedVượt hạn mức lượt gọi. Chờ số giây ghi ở headerRetry-Afterrồi thử lại.