এপিআই ডকুমেন্টেশন

শুরু করা

YTMP3CV.COM এপিআই ব্যবহার করতে, আপনার একটি এপিআই কী প্রয়োজন হবে। যদি আপনার এখনও একটি না থাকে, শুরু করতে আমাদের সাথে যোগাযোগ করুন।

সমস্ত এপিআই অনুরোধ নিম্নলিখিত বেস URL-এ করা উচিত:

https://api.ytmp3cv.com/

প্রমাণীকরণ

সমস্ত অনুরোধের হেডারে আপনার এ��িআই কী অন্তর্ভুক্ত করুন:

Authorization: Bearer YOUR_API_KEY

এন্ডপয়েন্ট

ইউটিউব থেকে এমপি৩-এ রূপান্তর করুন

POST /convert

একটি ইউটিউব ভিডিওকে এমপি৩ ফরম্যাটে রূপান্তর করুন।

প্যারামিটার

নাম	ধরন	বিবরণ
url	string	ইউটিউব ভিডিও URL
quality	string	ঐচ্ছিক। অডিও মান (উচ্চ, মাঝারি, নিম্ন)। ডিফল্ট: উচ্চ

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


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

data = {
    'url': 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
    'quality': 'high'
}

response = requests.post('https://api.ytmp3cv.com/convert', headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    print(f"Download URL: {result['download_url']}")
else:
    print(f"Error: {response.status_code}")

রূপান্তরের স্থিতি পান

GET /status/{conversion_id}

একটি রূপান্তর কাজের স্থিতি পরীক্ষা করুন।

প্যারামিটার

নাম	ধরন	বিবরণ
conversion_id	string	রূপান্তর কাজের আইডি

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


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}'
}

conversion_id = 'abc123'
response = requests.get(f'https://api.ytmp3cv.com/status/{conversion_id}', headers=headers)

if response.status_code == 200:
    result = response.json()
    print(f"Status: {result['status']}")
    print(f"Progress: {result['progress']}%")
else:
    print(f"Error: {response.status_code}")

ব্যাচ রূপান্তর

POST /batch-convert

একটি একক অনুরোধে একাধিক ইউটিউব ভিডিও এমপি৩ ফরম্যাটে রূপান্তর করুন।

প্যারামিটার

নাম	ধরন	বিবরণ
urls	array	ইউটিউব ভিডিও URL-এর একটি অ্যারে
quality	string	ঐচ্ছিক। অডিও মান (উচ্চ, মাঝারি, নিম্ন)। ডিফল্ট: উচ্চ

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


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

data = {
    'urls': [
        'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
        'https://www.youtube.com/watch?v=9bZkp7q19f0'
    ],
    'quality': 'high'
}

response = requests.post('https://api.ytmp3cv.com/batch-convert', headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    for job in result['jobs']:
        print(f"Conversion ID: {job['conversion_id']}")
else:
    print(f"Error: {response.status_code}")

রেট সীমাবদ্ধকরণ

ন্যায্য ব্যবহার নিশ্চিত করতে এবং পরিষেবার মান বজায় রাখতে, আমাদের এপিআই রেট সীমাবদ্ধকরণ প্রয়োগ করে। বর্তমান সীমাগুলি হল:

সময়কাল	অনুরোধ সীমা
প্রতি মিনিট	100 requests
প্রতি ঘন্টা	1,000 requests
প্রতি দিন	10,000 requests

যদি আপনি এই সীমাগুলি অতিক্রম করেন, আপনি একটি 429 Too Many Requests প্রতিক্রিয়া পাবেন। প্রতিক্রিয়াটিতে নিম্নলিখিত হেডার অন্তর্ভুক্ত থাকবে:

X-RateLimit-Limit: সেই নির্দিষ্ট অনুরোধের জন্য রেট সীমার সর্বোচ্চ সীমা
X-RateLimit-Remaining: সময় উইন্ডোর জন্য বাকি অনুরোধের সংখ্যা
X-RateLimit-Reset: UTC এপোক সেকেন্ডে রেট সীমা পুনরায় সেট হওয়ার আগে বাকি উইন্ডো

আপনার নির্দিষ্ট ব্যবহারের ক্ষেত্রে উপযুক্ত উচ্চতর রেট সীমার জন্য, অনুগ্রহ করে আমাদের বিক্রয় দলের সাথে যোগাযোগ করুন।

ত্রুটি পরিচালনা

বিবরণ

কোড	বিবরণ
200 OK	অনুরোধটি সফল ছিল।
400 Bad Request	অনুরোধটি অবৈধ বা পরিবেশন করা যায় না। নির্দিষ্ট ত্রুটিটি ত্রুটি বার্তায় ব্যাখ্যা করা হয়েছে।
401 Unauthorized	অনুরোধটির ব্যবহারকারী প্রমাণীকরণ প্রয়োজন।
403 Forbidden	সার্ভার অনুরোধটি বুঝেছে কিন্তু এটি অনুমোদন করতে অস্বীকার করছে।
404 Not Found	অনুরোধকৃত সম্পদটি পাওয়া যায়নি।
429 Too Many Requests	আপনি একটি নির্দিষ্ট সময়ের মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন।
500 Internal Server Error	আমাদের সার্ভারে একটি সমস্যা হয়েছে। পরে আবার চেষ্টা করুন।

সমস্ত ত্রুটি প্রতিক্রিয়ায় প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে একটি JSON অবজেক্ট অন্তর্ভুক্ত থাকবে:


{
    "error": {
        "code": "ERROR_CODE",
        "message": "A human-readable error message"
    }
}

আমরা আপনার অ্যাপ্লিকেশনে এই পরিস্থিতিগুলি সুন্দরভাবে পরিচালনা করতে এবং একটি মসৃণ ব্যবহারকারী অভিজ্ঞতা প্রদান করতে উপযুক্ত ত্রুটি পরিচালনা বাস্তবায়ন করার পরামর্শ দিই।

আমাদের এপিআই দিয়ে শুরু করুন

আপনার অ্যাপ্লিকেশনে আমাদের শক্তিশালী ইউটিউব থেকে এমপি৩ রূপান্তর একীভূত করতে প্রস্তুত?

বিক্রয় দলের সাথে যোগাযোগ করুন