Felo API PlatformFelo API Platform

গাইড

Data API ওভারভিউ

একটি শেয়ার করা প্রিফিক্স দিয়ে তৃতীয় পক্ষের endpoints কল করুন এবং অথেন্টিকেশন ও অনুরোধ প্রসেসিং একই রকম রাখুন।

Data API হলো একটি Felo key-এর পেছনে তৃতীয় পক্ষের API-র ক্যাটালগ। এটি Felo-র নিজস্ব /v2 API এবং Model API থেকে আলাদা।

শেয়ার করা প্রিফিক্স

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

রেফারেন্সে প্রতিটি endpoint /v1/beta দিয়ে শুরু হওয়া একটি সম্পূর্ণ path হিসেবে দেখানো হয়। হোস্টে সেই path ঠিক যেমন আছে তেমন ব্যবহার করুন; শেয়ার করা প্রিফিক্স আবার শুরুতে যোগ করবেন না। উদাহরণস্বরূপ, Tavily সার্চ endpoint হলো:

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

একটি endpoint খুঁজুন

  • সরবরাহকারী অনুযায়ী API ডিরেক্টরি ব্রাউজ করুন।
  • সম্পূর্ণ endpoint তালিকা, প্যারামিটার ও রেসপন্স স্কিমার জন্য Data API রেফারেন্স খুলুন।
  • সরবরাহকারীদের মধ্যে চলাচল করতে রেফারেন্সের tag ব্যবহার করুন।

প্রতিটি সরবরাহকারী নিজের অনুরোধের গঠন রাখে। শেয়ার করা স্তর প্রমাণীকরণ ও রাউটিং মানসম্মত করে, পেলোড নয়। অনুরোধ পাঠানোর আগে endpoint স্কিমা পড়ুন।

প্রমাণীকরণ

যেকোনো একটি header ব্যবহার করুন:

Authorization: Bearer $FELO_API_KEY

অথবা:

X-API-Key: $FELO_API_KEY

JSON বডির জন্য Content-Type: application/json পাঠান।

উদাহরণ অনুরোধ

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

রেসপন্সের গঠন সরবরাহকারী থেকে আসে। results, pagination cursor ও metadata-র মতো ফিল্ডগুলো প্রোভাইডার জুড়ে মানসম্মত করা হয় না।

রীতিনীতি

বিষয়কী প্রত্যাশা করবেন
পেলোডসরবরাহকারী-নির্দিষ্ট JSON; endpoint স্কিমা অনুসরণ করুন
পেজিনেশনফিল্ডের নাম ও cursor স্টাইল endpoint অনুযায়ী ভিন্ন
ত্রুটিstatus, code, message ও request_id সহ JSON; প্রোভাইডারের বিবরণ message-এ আসতে পারে
রেট সীমাendpoint ও সরবরাহকারী-নির্দিষ্ট; লোডের সময় 429 প্রত্যাশা করুন
বিলিংপ্রতি কলে, Model API-র মতো একই পরিষেবা ক্রেডিট ব্যালেন্স থেকে

ত্রুটি সামলানো

প্রমাণীকরণ ব্যর্থ হলে প্ল্যাটফর্মের বাকি অংশের মতো একই envelope ফেরত আসে:

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

প্রোভাইডার-স্তরের ব্যর্থতার জন্য HTTP স্ট্যাটাস ও message পড়ুন। method, সম্পূর্ণ path, অনুরোধ বডির গঠন ও request_id লগ করুন। সম্পূর্ণ API key লগ করবেন না।

রিট্রাই

ব্যাকঅফসহ 429 ও 5xx রেসপন্স রিট্রাই করুন। 400 বা 401 অপরিবর্তিত অবস্থায় রিট্রাই করবেন না। কিছু প্রোভাইডার অপারেশন পুনরাবৃত্তি করা নিরাপদ নয়; একটি write রিট্রাই করার আগে endpoint দেখুন।

কখন বরং একটি Felo API ব্যবহার করবেন

আপনার নির্দিষ্ট তৃতীয় পক্ষের ডেটা উৎস দরকার হলে Data API ব্যবহার করুন। Felo-র নিজস্ব ওয়ার্কফ্লো চাইলে একটি Felo API ব্যবহার করুন:

সম্পর্কিত