API কী? - একটি পূর্ণাঙ্গ গাইডলাইন
API কী? – একটি পূর্ণাঙ্গ গাইড
বর্তমান ডিজিটাল যুগে আমরা প্রতিদিন বিভিন্ন ওয়েবসাইট, অ্যাপ এবং সফটওয়্যার ব্যবহার করি। কিন্তু এই সব সিস্টেম কীভাবে একে অপরের সাথে তথ্য শেয়ার করে? এখানেই কাজ করে API, যা অর্থাৎ Application Programming Interface।
১. API-এর সংজ্ঞা
API হলো দুই সফটওয়্যার বা সিস্টেমের মধ্যে তথ্য আদানপ্রদানের মাধ্যম। সহজ কথায়, এটি এমন একটি দরজা বা সেতু, যার মাধ্যমে আপনার ওয়েবসাইট বা অ্যাপ অন্য সফটওয়্যারের তথ্য গ্রহণ বা পাঠাতে পারে।
উদাহরণ:
- আপনার ওয়েবসাইটে DSE বা Dhaka Stock Exchange এর লাইভ শেয়ার প্রাইস দেখানো।
- ওয়েদার অ্যাপ্লিকেশনে তাপমাত্রা বা বাতাসের গতি দেখানো।
- গুগল ম্যাপ ওয়েবসাইটে এম্বেড করা।
২. API কিভাবে কাজ করে?
API কাজ করে request-response পদ্ধতিতে।
- Request (অনুরোধ): আপনার ওয়েবসাইট API-কে জিজ্ঞেস করে, যেমন: “আমাকে DSEX ইনডেক্সের তথ্য দিন।”
- Response (প্রতিক্রিয়া): API সার্ভার JSON, XML বা CSV ফরম্যাটে তথ্য পাঠায়। উদাহরণ:
{
"DSEX": 6700.23,
"date": "2026-03-16"
}
3️⃣ Display (প্রদর্শন): আপনার ওয়েবসাইট সেই তথ্য নিয়ে ব্যবহারকারীর জন্য সুন্দরভাবে দেখায়।
৩. API-এর প্রধান সুবিধা
- স্বয়ংক্রিয় আপডেট: লাইভ তথ্য ওয়েবসাইটে রিফ্রেশ হয়।
- স্ট্রাকচার্ড ডেটা: JSON বা XML ফরম্যাটে আসে, যা ওয়েবসাইটে সহজে প্রদর্শনযোগ্য।
- দ্রুত এবং নির্ভরযোগ্য: অফিসিয়াল API ব্যবহার করলে ডেটা সঠিক ও সর্বশেষ থাকে।
- সিকিউরিটি: API key ব্যবহার করে শুধুমাত্র অনুমোদিত ব্যবহারকারী তথ্য অ্যাক্সেস করতে পারে।
৪. API-এর ধরন
- ওয়েব API (Web API): ওয়েবসাইট বা অ্যাপ থেকে HTTP প্রটোকলের মাধ্যমে ডেটা নেয়। উদাহরণ: REST API, SOAP API
- লাইব্রেরি API (Library API): কোনো সফটওয়্যারের ফাংশন ব্যবহার করার জন্য। উদাহরণ: Python বা Java লাইব্রেরি API
- ওএস API (Operating System API): OS-এর ফাংশন বা সার্ভিস অ্যাক্সেস করতে ব্যবহার হয়। উদাহরণ: Windows API, Android API
৫. API ব্যবহার করে ওয়েবসাইটে তথ্য প্রদর্শনের উদাহরণ
ধরি আপনি চান আপনার ওয়েবসাইটে DSE এর লাইভ ইনডেক্স দেখাতে।
ধাপসমূহ:
- Official বা unofficial API থেকে ডেটা নিন।
- JavaScript বা PHP ব্যবহার করে JSON ডেটা প্রসেস করুন।
- ওয়েবপেজে লাইভ ইনডেক্স দেখান।
JavaScript উদাহরণ:
Loading...
এতে DSE এর ডেটা automatic refresh হবে এবং ব্যবহারকারীরা সবসময় লাইভ তথ্য দেখতে পারবেন।
কীভাবে API একটি Website এ সেট করতে হয়? API সেট করার নিয়ম
১. API ব্যবহারের ধাপ
ধাপ ১: API পাওয়া
যদি API পাবলিক হয়:
উদাহরণ: DSE API, OpenWeatherMap API
ডকুমেন্টেশন থেকে রেজিস্ট্রেশন ও API key নিন।
যদি API প্রাইভেট হয়:
ওয়েবসাইটের ডেভেলপার টিমের সাথে যোগাযোগ করে access নিতে হবে।
কিছু ক্ষেত্রে web scraping এর মাধ্যমে ডেটা পাওয়া যায়, কিন্তু API ব্যবহার করা নিরাপদ ও দ্রুত।
উদাহরণ: DSE এর রিয়েল-টাইম শেয়ার ডেটার জন্য API key দরকার।
ধাপ ২: API এর ডকুমেন্টেশন বুঝা
ডকুমেন্টেশনে সাধারণত থাকে:
API Endpoint: URL যেখানে ডেটা পাওয়া যাবে
HTTP Method: GET (ডেটা নেওয়া), POST (ডেটা পাঠানো), PUT, DELETE
Parameters: কোন filter বা option দিতে হবে
Response Format: JSON বা XML
উদাহরণ:
Endpoint: https://api.dsebd.org/v1/stocks
Method: GET
Parameter: symbol=BATBC
Response: { "symbol": "BATBC", "price": 280.50 }
ধাপ ৩: ওয়েবসাইটে API কল করা
আপনি চাইলে JavaScript (frontend) বা PHP/Python (backend) ব্যবহার করতে পারেন।
Front-end (JavaScript) উদাহরণ
JavaScript
Copy code
fetch('https://api.dsebd.org/v1/stocks?symbol=BATBC')
.then(response => response.json())
.then(data => {
console.log(data);
document.getElementById('stock-price').innerText = data.price;
})
.catch(error => console.error('Error:', error));
HTML:
HTML
Copy code
<p>BATBC Price: <span id="stock-price">Loading...</span></p>
Back-end (PHP) উদাহরণ
PHP
Copy code
<?php
$url = "https://api.dsebd.org/v1/stocks?symbol=BATBC";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo "BATBC Price: " . $data['price'];
?>
ধাপ ৪: ডেটা ওয়েবসাইটে দেখানো
JSON data পার্স করা
HTML element-এ inject করা (যেমন <div> বা <span>)
Optional: AJAX ব্যবহার করে page refresh ছাড়া update করা
ধাপ ৫: Security ও Performance
API key কোনো public place (frontend) রাখবেন না, যদি sensitive হয়।
Server-side (PHP/Python) দিয়ে API কল করলে নিরাপদ।
Caching ব্যবহার করুন, যদি ডেটা খুব frequent update হয় না।
Error handling implement করুন।
ধাপ ৬: Automation
Real-time data চাইলে setInterval() (JavaScript) বা cron job (backend) ব্যবহার করে periodical update করতে পারেন।
Example: প্রতি 10 সেকেন্ডে DSE price update করা।
JavaScript
Copy code
setInterval(() => {
fetch('https://api.dsebd.org/v1/stocks?symbol=BATBC')
.then(res => res.json())
.then(data => document.getElementById('stock-price').innerText = data.price);
}, 10000);
৭. মূল টিপস
সবসময় API ডকুমেন্টেশন পড়ুন।
Free API-র rate limit আছে, একসাথে অনেক request করলে block হতে পারে।
Backend দিয়ে call করলে API key hide থাকে।
JSON ডেটা পার্স করা খুব সহজ, XML হলে একটু আলাদা handling করতে হবে।
৬. API-এর গুরুত্বপূর্ণ বিষয়সমূহ
- Rate Limit: এক API কতবার ব্যবহার করা যাবে।
- Authentication: অনেক API key বা token চায়।
- Documentation: API এর ব্যবহার শেখার জন্য ডকুমেন্টেশন গুরুত্বপূর্ণ।
- Data Format: JSON বা XML ডেটা ফরম্যাটে আসে।
৭. সারসংক্ষেপ
API হলো প্রোগ্রাম এবং সার্ভারের মধ্যে সেতু, যা ওয়েবসাইট বা অ্যাপকে live এবং dynamic তথ্য প্রদর্শনের ক্ষমতা দেয়।
API ব্যবহার করে আপনি ওয়েবসাইটে দেখাতে পারবেন:
- লাইভ শেয়ার প্রাইস
- লাইভ ওয়েদার আপডেট
- ম্যাপ বা অন্যান্য ডেটা
দ্রষ্টব্য: Official API ব্যবহার করলে ডেটা সর্বশেষ ও নির্ভরযোগ্য থাকে, আর unofficial API বা scraping করলে ওয়েবসাইটের উপর নির্ভরতা থাকে এবং মাঝে মাঝে ডেটা পাওয়ায় সমস্যা হতে পারে।
Comments