# FAQ API
SUMMARY: Câu hỏi API phổ biến — xác thực, giới hạn tốc độ, xử lý lỗi, khám phá endpoint.

FAQ API
Các câu hỏi phổ biến về Synapse API.
Làm thế nào để xác thực?
Hai phương thức:
1. Mind Key (cho endpoint dữ liệu): 
2. JWT (cho endpoint tài khoản): 
Hoặc qua tham số query (giới hạn 60 yêu cầu/phút): 
Xem Xác thực.
Sự khác biệt giữa Mind Key và JWT là gì?
- Mind Key: phạm vi tenant, không bao giờ hết hạn, cho dữ liệu memory/chat/tasks
- JWT: phạm vi người dùng, hết hạn sau 7 ngày, cho quản lý tài khoản/mind
Xem Mind Key vs JWT.
Tại sao tôi nhận 401 Unauthorized?
Nguyên nhân phổ biến:
1. Thiếu header 
2. Mind Key không hợp lệ (xác minh nó bắt đầu bằng )
3. Sử dụng JWT nơi yêu cầu Mind Key (hoặc ngược lại)
4. Mind Key đã bị thu hồi
Khắc phục: Xác minh token của bạn. Xem Xác thực.
Tại sao tôi nhận 404 Not Found?
Bạn đã dùng sai đường dẫn endpoint. Synapse chỉ có các đường dẫn liệt kê trong
.
Khắc phục: Gọi  để xem tất cả đường dẫn hợp lệ. Không đoán.
Tại sao tôi nhận 429 Too Many Requests?
Bạn đang sử dụng xác thực tham số query , bị giới hạn 60/phút.
Khắc phục: Chuyển sang header  (không giới hạn tốc độ).
Xem Giới hạn tốc độ.
Làm thế nào để liệt kê tất cả endpoint?
[CODE BLOCK]
Làm thế nào để tìm đúng endpoint?
1. Kiểm tra  cho danh sách đọc bằng máy
2. Kiểm tra  cho tài liệu API đầy đủ
3. Duyệt  cho hệ thống tài liệu
4. Sử dụng  cho đặc tả OpenAPI 3.0
Tôi có thể dùng GET thay vì POST không?
Một số endpoint POST có phiên bản GET tương đương cho công cụ chỉ dùng URL:
-  ↔ 
-  ↔ 
-  ↔ 
Kiểm tra  cho các biến thể GET khả dụng.
Làm thế nào để xử lý lỗi?
Tất cả lỗi trả về JSON:
[CODE BLOCK]
Xem Lỗi & Xử lý lỗi.
Giới hạn body yêu cầu là bao nhiêu?
10 MB. Cho payload lớn hơn (ví dụ tải tệp lên), sử dụng các endpoint multipart.
API có hỗ trợ CORS không?
Có. Tất cả endpoint trả về:
[CODE BLOCK]
Có SDK không?
Có:
- Node.js: 
- MCP: 
Xem Tổng quan API để biết chi tiết.
Làm thế nào để phân trang?
Sử dụng  và :
[CODE BLOCK]
Giới hạn mặc định: 100. Tối đa: 500.
Tôi có thể lọc bộ nhớ theo danh mục hoặc tag không?
Có:
[CODE BLOCK]
Làm thế nào để tìm kiếm bộ nhớ?
Hai cách:
1. Tìm kiếm từ khóa FTS5: 
2. Tìm kiếm ngữ nghĩa: 
Xem Tìm kiếm FTS5 và Tìm kiếm ngữ nghĩa.
Làm thế nào để cập nhật bộ nhớ?
POST  với cùng  +  — bộ nhớ hiện có được cập nhật, không
trùng lặp.
[CODE BLOCK]
Làm thế nào để xóa bộ nhớ?
[CODE BLOCK]
Tôi có thể xóa hàng loạt không?
Có:
[CODE BLOCK]
Bước tiếp theo
- Tổng quan API
- Lỗi & Xử lý lỗi
- Xác thực