API ওয়ার্কফ্লো গাইড

আপনি কি তৈরি করতে চান?

আপনার কাজের সবচেয়ে কাছাকাছি ফলাফলটি বেছে নিন। প্রতিটি পথ আপনাকে একটি কার্যকরী রিকোয়েস্ট, রেসপন্সে কী থাকা উচিত, এটি কাজ করেছে কিনা তা কীভাবে চেক করতে হয় এবং পরবর্তী দরকারী পদক্ষেপ প্রদান করে।

পাঁচটি ব্যবহারিক পথ

ফলাফল দিয়ে শুরু করুন, এন্ডপয়েন্ট লিস্ট দিয়ে নয়।

Selected: Harden a client

পাথ 1 ম্যাক্রো ডেটা ফেচ করুন একটি পরিষ্কার টাইম সিরিজ পুনরুদ্ধার করুন এবং এর পাশাপাশি উৎস এবং মানের মেটাডেটা রাখুন। পাথ 2 রিলিজ জব প্ল্যান করুন পরিচিত পাবলিকেশন সময়ের আশেপাশে টার্গেটেড জব চালানোর জন্য রিলিজ ক্যালেন্ডার ব্যবহার করুন। পাথ 3 সারপ্রাইজ পরিমাপ করুন লুকঅ্যাহেড বায়াস তৈরি না করে প্রকাশিত মানের সাথে প্রি-রিলিজ পূর্বাভাসগুলো যুক্ত করুন। পাথ 4 লাইভ আপডেট পান SSE কে একটি ইনভ্যালিডেশন সিগন্যাল হিসেবে ব্যবহার করুন, তারপর REST থেকে সম্পূর্ণ রেকর্ডটি ফেচ করুন। পাথ 5 একটি ম্যাক্রো মডেল তৈরি করুন সম্পর্কিত ইন্ডিকেটরগুলোর একটি ছোট গ্রুপকে সোর্স-লেবেলড কারেন্সি স্কোরকার্ডে রূপান্তর করুন।

আপনার 14-দিনের API ট্রায়াল

প্রথম রিকোয়েস্ট থেকে একটি দীর্ঘস্থায়ী পেশাদার কাজে উন্নীত হন।

লক্ষ্য প্রতিটি প্রোডাক্ট পেজ ভিজিট করা নয়। লক্ষ্য হলো দরকারী অথেন্টিকেটেড API কাজ সম্পন্ন করা, অন্য একদিন ফিরে আসা এবং একটি রিপিটেবল ডেটাসেট বা অ্যাপ্লিকেশন ওয়ার্কফ্লো নিয়ে চলে যাওয়া।

API প্রগতি পরীক্ষা করুন

দিন 0

অ্যাক্সেস প্রমাণ করুন

কী (key) তৈরি করুন, একটি অথেন্টিকেটেড রিকোয়েস্ট সম্পন্ন করুন এবং এর মেটাডেটা সহ প্রথম রেসপন্সটি সংরক্ষণ করুন।

ধাপটি খুলুন →

দিন 1-2

রিকোয়েস্টটিকে নির্ভরযোগ্য করুন

অথেন্টিকেশন বা ফিল্টার সমস্যা সমাধান করুন এবং প্রথম স্ক্রিপ্টটিকে একটি নামযুক্ত রিপিটেবল জবে পরিণত করুন।

ধাপটি খুলুন →

দিন 3-4

রিলিজ টাইমিং যোগ করুন

ক্যালেন্ডারটিকে দ্বিতীয় এন্ডপয়েন্ট ফ্যামিলি হিসেবে ব্যবহার করুন এবং পরবর্তী দরকারী API রান শিডিউল করুন।

ধাপটি খুলুন →

দিন 5-7

রিসার্চ আউটপুট তৈরি করুন

প্রত্যাশা বা ম্যাক্রো সিরিজের একটি ছোট গ্রুপ যোগ করুন, তারপর একটি সংরক্ষিত তুলনা, টেবিল বা স্কোরকার্ড তৈরি করুন।

ধাপটি খুলুন →

দিন 8-10

আপডেট অটোমেট করুন

শিডিউলড REST, SSE, অথবা ওয়েবহুক বেছে নিন এবং অন্য একদিনে আরেকটি সফল API রান সম্পন্ন করুন।

ধাপটি খুলুন →

দিন 11-13

ক্লায়েন্টকে আরও শক্তিশালী করুন

টাইমআউট, বাউন্ডেড রিট্রাই, রেসপন্স ভ্যালিডেশন, ক্রেডেনশিয়াল-সেফ লগিং এবং স্টেল-ডেটা মনিটরিং যোগ করুন।

ধাপটি খুলুন →

দিন 14

প্রমাণ পর্যালোচনা করুন

নিশ্চিত করুন যে API একটি পুনরাবৃত্তিযোগ্য কাজ সরবরাহ করে যা আপনার টিম ধরে রাখবে, তারপর পরবর্তী ডেটাসেট বা অ্যাপ্লিকেশন ওয়ার্কফ্লো বেছে নিন।

ধাপটি খুলুন →

Production readiness

একটি API ক্লায়েন্টকে প্রোডাকশন-রেডি করুন

Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.

25 minutes Production pattern ঘোষণাchangesstreamwebhooks

কার্যকর উদাহরণ

আপনার কি (key) রাখুন FXMD_API_KEY; এটি কখনোই সোর্স কন্ট্রোলে পেস্ট করবেন না।

import os
import requests
from urllib3.util.retry import Retry

session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))

response = session.get(
    "https://api.fxmacrodata.com/v1/announcements/eur/inflation",
    params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
    headers={"Accept-Encoding": "gzip"},
    timeout=(3.05, 20),
)
response.raise_for_status()

প্রত্যাশিত ফলাফল: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.

যখন প্রথম স্ক্রিপ্টটি একটি প্রকৃত সিস্টেমে পরিণত হয়

ট্রাবলশুটিং এবং প্রোডাকশন গাইডেন্স

যখন কোনো রেসপন্স ব্যর্থ হয়, কোনো ডেটা রিটার্ন করে না, অথবা ক্যাশিং, টাইমআউট, রিট্রাই এবং ইভেন্ট ডেলিভারির মতো প্রোডাকশন কন্ট্রোল প্রয়োজন হয়, তখন এই গাইডগুলো ব্যবহার করুন।

গাইডএটি ব্যবহার করুন যখনশুরু করুন
একটি ব্যর্থ বা খালি রেসপন্স নির্ণয় করুন আপনার কি (key) প্রকাশ না করেই অথেন্টিকেশন, অ্যাক্সেস, পাথ, রেট-লিমিট এবং ডেটা-অ্যাভেইলেবিলিটি সমস্যাগুলোকে আলাদা করুন। গাইড খুলুন →
একটি API ক্লায়েন্টকে প্রোডাকশন-রেডি করুন টাইমআউট, বাউন্ডেড রিট্রাই, ক্যাশিং, কন্ডিশনাল রিকোয়েস্ট এবং সঠিক ডেলিভারি প্যাটার্ন যোগ করুন। গাইড খুলুন →