وثائق واجهة برمجة التطبيقات

البدء

لاستخدام واجهة برمجة التطبيقات الخاصة بـ YTMP3CV.COM، ستحتاج إلى مفتاح API. إذا لم يكن لديك واحد بعد، اتصل بنا للبدء.

يجب إجراء جميع طلبات API إلى عنوان URL الأساسي التالي:

https://api.ytmp3cv.com/

المصادقة

قم بتضمين مفتاح API الخاص بك في رأس جميع الطلبات:

Authorization: Bearer YOUR_API_KEY

نقاط النهاية

تحويل يوتيوب إلى MP3

POST /convert

تحويل فيديو يوتيوب إلى تنسيق MP3.

المعلمات

الاسم	النوع	الوصف
url	string	رابط فيديو يوتيوب
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

تحويل مقاطع فيديو يوتيوب متعددة إلى تنسيق MP3 في طلب واحد.

المعلمات

الاسم	النوع	الوصف
urls	array	مصفوفة من روابط فيديو يوتيوب
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: النافذة المتبقية قبل إعادة تعيين حد معدل الاستخدام بالثواني الزمنية العالمية

للحصول على حدود معدل استخدام أعلى مصممة خصيصًا لحالة الاستخدام المحددة الخاصة بك، يرجى الاتصال بفريق المبيعات لدينا.

معالجة الأخطاء

الوصف

الرمز	الوصف
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"
    }
}

نوصي بتنفيذ معالجة الأخطاء المناسبة في تطبيقك لإدارة هذه السيناريوهات بسلاسة وتوفير تجربة مستخدم سلسة.

ابدأ مع واجهة برمجة التطبيقات الخاصة بنا

هل أنت مستعد لدمج تحويل يوتيوب إلى MP3 القوي في تطبيقك؟

اتصل بالمبيعات