মূল ওয়েবসাইটে ফিরে যান

Caption API গাইডলাইন

আপনার ওয়েবসাইট বা অ্যাপে খুব সহজেই বাংলা টুলবক্সের প্রিমিয়াম ক্যাপশন এপিআই ইন্টিগ্রেট করুন। নিচে দেওয়া নিয়মাবলি এবং কোডগুলো ফলো করুন।

১. অথেনটিকেশন (API Key)

এপিআই ব্যবহার করার জন্য আপনার একটি বৈধ API Key প্রয়োজন হবে। রিকোয়েস্ট পাঠানোর সময় হেডারে x-api-key প্যারামিটার ব্যবহার করে আপনার কি (Key) পাঠাতে হবে।

HEADER x-api-key: YOUR_SECRET_API_KEY

২. এপিআই এন্ডপয়েন্ট (Endpoint)

ক্যাপশন এবং বায়ো ফেচ করার জন্য নিচের এন্ডপয়েন্টটি ব্যবহার করুন।

GET https://banglatools.top/api/v1/captions

কুইরি প্যারামিটার (Query Parameters):

প্যারামিটার ধরণ বিবরণ
category String (Required) ক্যাপশনের ক্যাটাগরি (যেমন: attitude, love, sad, islamic, funny)
limit Integer (Optional) কতগুলো ক্যাপশন চান। ডিফল্ট: 10, সর্বোচ্চ: 50

৩. কোড ইন্টিগ্রেশন (উদাহরণ)

নিচে বিভিন্ন প্রোগ্রামিং ভাষায় এপিআই ইন্টিগ্রেট করার উদাহরণ দেওয়া হলো।

JavaScript (Fetch API)

const apiKey = 'YOUR_SECRET_API_KEY';
const category = 'attitude';

fetch(`https://banglatools.top/api/v1/captions?category=${category}`, {
    method: 'GET',
    headers: {
        'x-api-key': apiKey,
        'Content-Type': 'application/json'
    }
})
.then(response => response.json())
.then(data => {
    console.log('Captions:', data.captions);
    // আপনার ওয়েবসাইটে ক্যাপশনগুলো শো করান
})
.catch(error => console.error('Error:', error));

PHP (cURL)

<?php
$apiKey = 'YOUR_SECRET_API_KEY';
$category = 'love';
$url = "https://banglatools.top/api/v1/captions?category=" . $category;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "x-api-key: $apiKey",
    "Content-Type: application/json"
));

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data['captions']);
?>

Python (Requests)

import requests

url = "https://banglatools.top/api/v1/captions"
headers = {
    "x-api-key": "YOUR_SECRET_API_KEY"
}
params = {
    "category": "islamic",
    "limit": 5
}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    print("Captions:", data.get('captions'))
else:
    print("Error:", response.status_code)

৪. রেসপন্স ফরম্যাট (JSON)

সফল রিকোয়েস্টের পর আপনি নিচের মতো একটি JSON রেসপন্স পাবেন:

{
  "status": "success",
  "category": "attitude",
  "total": 2,
  "captions": [
    "আমার অ্যাটিটিউড আমার স্টাইল, এটা কপি করার চেষ্টা করো না! 😎",
    "আমি যেমন, আমি তেমনই। কারো জন্য নিজেকে বদলাতে পারবো না। 🔥"
  ]
}

এরর রেসপন্স (Error Response):

{
  "status": "error",
  "message": "Invalid API Key or Limit Exceeded"
}

© 2026 Bangla Tool Box | Developed by Rakib Hasan