Felo API PlatformFelo API Platform

Kılavuzlar

Data API'ye genel bakış

Üçüncü taraf endpoint'lerini ortak bir önek altında, aynı kimlik doğrulama ve istek işleme düzeniyle çağırın.

Data API, tek bir Felo anahtarı arkasındaki üçüncü taraf API'ler kataloğudur. Felo'nun kendi /v2 API'lerinden ve Model API'den ayrıdır.

Paylaşılan önek

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

Referans, her endpoint'i /v1/beta ile başlayan tam bir yol olarak gösterir. Bu yolu ana makinede olduğu gibi kullanın; paylaşılan öneki yeniden başa eklemeyin. Örneğin, Tavily arama endpoint'i şudur:

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

Bir endpoint bulma

  • API dizinine sağlayıcıya göre göz atın.
  • Tam endpoint listesi, parametreler ve yanıt şemaları için Data API referansını açın.
  • Sağlayıcılar arasında geçiş yapmak için referansın etiketlerini kullanın.

Her sağlayıcı kendi istek biçimini korur. Paylaşılan katman kimlik doğrulamayı ve yönlendirmeyi standartlaştırır, yükü değil. İstek göndermeden önce endpoint şemasını okuyun.

Kimlik Doğrulama

İki başlıktan birini kullanın:

Authorization: Bearer $FELO_API_KEY

veya:

X-API-Key: $FELO_API_KEY

JSON gövdeleri için Content-Type: application/json gönderin.

Örnek istek

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
  }'

Yanıt biçimi sağlayıcıdan gelir. Sonuçlar, sayfalama imleçleri ve meta veriler gibi alanlar sağlayıcılar arasında normalize edilmez.

Kurallar

KonuNe beklemeli
YükSağlayıcıya özgü JSON; endpoint şemasını izleyin
SayfalamaAlan adları ve imleç stilleri endpoint'e göre değişir
Hatalarstatus, code, message ve request_id içeren JSON; sağlayıcı ayrıntıları mesajda görünebilir
Hız sınırlarıEndpoint ve sağlayıcıya özgü; yük altında 429 bekleyin
FaturalandırmaÇağrı başına, Model API ile aynı hizmet kredisi bakiyesinden

Hata yönetimi

Bir kimlik doğrulama arızası, platformun geri kalanıyla aynı zarfı döndürür:

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

Sağlayıcı düzeyindeki bir arıza için HTTP durumunu ve mesajı okuyun. Yöntemi, tam yolu, istek gövdesi biçimini ve request_id değerini günlüğe kaydedin. Tam API anahtarını günlüğe kaydetmeyin.

Yeniden denemeler

429 ve 5xx yanıtlarını geri çekilmeyle yeniden deneyin. 400 veya 401'i değiştirmeden yeniden denemeyin. Bazı sağlayıcı işlemlerinin yinelenmesi güvenli değildir; bir yazma işlemini yeniden denemeden önce endpoint'i kontrol edin.

Bunun yerine ne zaman bir Felo API kullanmalı

Belirli bir üçüncü taraf veri kaynağına ihtiyaç duyduğunuzda Data API'yi kullanın. Felo'nun kendi iş akışını istediğinizde bir Felo API kullanın:

İlgili