Felo API PlatformFelo API Platform

Hướng dẫn

Tổng quan Data API

Gọi endpoint bên thứ ba qua một tiền tố chung, với xác thực và xử lý yêu cầu nhất quán.

Data API là một danh mục các API bên thứ ba nằm sau một khóa Felo. Nó tách biệt với các API /v2 của chính Felo và với Model API.

Tiền tố chung

https://openapi.felo.ai/v1/beta

Tài liệu tham chiếu hiển thị mỗi endpoint dưới dạng đường dẫn đầy đủ bắt đầu bằng /v1/beta. Hãy dùng nguyên đường dẫn đó trên host; không thêm lại tiền tố chung. Ví dụ: endpoint tìm kiếm Tavily là:

POST https://openapi.felo.ai/v1/beta/tavily/search

Tìm một endpoint

  • Duyệt danh mục API theo nhà cung cấp.
  • Mở tham chiếu Data API để xem danh sách endpoint đầy đủ, tham số và lược đồ phản hồi.
  • Dùng các tag trong tài liệu tham chiếu để chuyển giữa các nhà cung cấp.

Mỗi nhà cung cấp giữ cấu trúc yêu cầu riêng. Lớp chung chỉ chuẩn hóa xác thực và định tuyến, không chuẩn hóa nội dung yêu cầu. Hãy đọc lược đồ endpoint trước khi gửi yêu cầu.

Xác thực

Dùng một trong hai header:

Authorization: Bearer $FELO_API_KEY

hoặc:

X-API-Key: $FELO_API_KEY

Gửi Content-Type: application/json cho nội dung JSON.

Ví dụ yêu cầu

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is Felo AI?",
    "max_results": 3
  }'

Cấu trúc phản hồi đến từ nhà cung cấp. Các trường như kết quả, con trỏ phân trang và siêu dữ liệu không được chuẩn hóa giữa các nhà cung cấp.

Quy ước

Chủ đềĐiều cần lưu ý
Nội dung yêu cầuJSON riêng của nhà cung cấp; làm theo lược đồ endpoint
Phân trangTên trường và kiểu con trỏ khác nhau theo endpoint
LỗiJSON với status, code, message và request_id; chi tiết từ nhà cung cấp có thể xuất hiện trong thông điệp
Giới hạn tần suấtRiêng theo endpoint và nhà cung cấp; hãy dự kiến 429 khi tải cao
Tính phíTheo từng lệnh gọi, từ cùng số dư tín dụng dịch vụ như Model API

Xử lý lỗi

Lỗi xác thực trả về cùng cấu trúc như phần còn lại của nền tảng:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "..."
}

Với lỗi ở cấp nhà cung cấp, hãy đọc trạng thái HTTP và thông điệp. Ghi lại phương thức, đường dẫn đầy đủ, cấu trúc nội dung yêu cầu và request_id. Không ghi toàn bộ khóa API vào nhật ký.

Thử lại

Thử lại các phản hồi 429 và 5xx với thời gian chờ tăng dần. Không thử lại 400 hoặc 401 nguyên trạng. Một số thao tác của nhà cung cấp không an toàn khi lặp lại; hãy kiểm tra endpoint trước khi thử lại một thao tác ghi.

Khi nào nên dùng Felo API thay thế

Dùng Data API khi bạn cần một nguồn dữ liệu bên thứ ba cụ thể. Dùng Felo API khi bạn muốn quy trình của chính Felo:

Liên quan