API दस्तावेज़ीकरण

शुरू करना

YTMP3CV.COM API का उपयोग करने के लिए, आपको एक API कुंजी की आवश्यकता होगी। यदि आपके पास अभी तक नहीं है, तो शुरू करने के लिए हमसे संपर्क करें।

सभी API अनुरोध निम्नलिखित आधार URL पर किए जाने चाहिए:

https://api.ytmp3cv.com/

प्रमाणीकरण

सभी अनुरोधों के हेडर में अपनी API कुंजी शामिल करें:

Authorization: Bearer YOUR_API_KEY

एंडपॉइंट्स

YouTube को MP3 में बदलें

POST /convert

YouTube वीडियो को MP3 प्रारूप में बदलें।

पैरामीटर

नाम	प्रकार	विवरण
url	string	YouTube वीडियो 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	रूपांतरण कार्य की ID

उदाहरण अनुरोध


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

एक ही अनुरोध में कई YouTube वीडियो को MP3 प्रारूप में बदलें।

पैरामीटर

नाम	प्रकार	विवरण
urls	array	YouTube वीडियो 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}")

दर सीमा

निष्पक्ष उपयोग सुनिश्चित करने और सेवा गुणवत्ता बनाए रखने के लिए, हमारा API दर सीमा लागू करता है। वर्तमान सीमाएँ हैं:

समय सीमा	अनुरोध सीमा
प्रति मिनट	100 requests
प्रति घंटा	1,000 requests
प्रति दिन	10,000 requests

यदि आप इन सीमाओं को पार करते हैं, तो आपको 429 बहुत अधिक अनुरोध प्रतिक्रिया प्राप्त होगी। प्रतिक्रिया में निम्नलिखित हेडर शामिल होंगे:

X-RateLimit-Limit: उस दिए गए अनुरोध के लिए दर सीमा सीमा
X-RateLimit-Remaining: समय विंडो के लिए बचे हुए अनुरोधों की संख्या
X-RateLimit-Reset: UTC एपोक सेकंड में दर सीमा रीसेट होने से पहले बची हुई विंडो

आपके विशिष्ट उपयोग मामले के लिए उच्च दर सीमाओं के लिए, कृपया हमारी बिक्री टीम से संपर्क करें।

त्रुटि प्रबंधन

विवरण

कोड	विवरण
200 OK	अनुरोध सफल रहा।
400 Bad Request	अनुरोध अमान्य था या उसे सेवा नहीं दी जा सकती। सटीक त्रुटि त्रुटि संदेश में समझाई गई है।
401 Unauthorized	अनुरोध का प्रमाण सत्यापित नहीं हुआ। अनुरोध को प्रमाण सत्यापित करने के लिए एक API कुंजी जोड़ें।
403 Forbidden	सर्वर ने अनुरोध को समझा लेकिन उसे अधिकृत करने से इनकार कर दिया।
404 Not Found	अनुरोधित संसाधन नहीं मिला।
429 Too Many Requests	आपने एक निश्चित समय में बहुत अधिक अनुरोध भेजे हैं।
500 Internal Server Error	हमारे सर्वर के साथ कोई समस्या थी। बाद में पुनः प्रयास करें।

सभी त्रुटि प्रतिक्रियाओं में निम्नलिखित संरचना के साथ प्रतिक्रिया बॉडी में एक JSON ऑब्जेक्ट शामिल होगा:


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

हम आपके एप्लिकेशन में उचित त्रुटि प्रबंधन को लागू करने की सिफारिश करते हैं ताकि इन परिदृश्यों को सुचारू रूप से प्रबंधित किया जा सके और एक सहज उपयोगकर्ता अनुभव प्रदान किया जा सके।

हमारे API के साथ शुरुआत करें

अपने एप्लिकेशन में हमारे शक्तिशाली YouTube से MP3 रूपांतरण को एकीकृत करने के लिए तैयार हैं?

बिक्री से संपर्क करें