API Dokümantasyonu

App.apiDescription

Başlarken

YTMP3CV.COM API'sini kullanmak için bir API anahtarına ihtiyacınız olacak. Henüz bir tane yoksa, başlamak için bizimle iletişime geçin.

Tüm API istekleri aşağıdaki temel URL'ye yapılmalıdır:

https://api.ytmp3cv.com/

Kimlik Doğrulama

API anahtarınızı tüm isteklerin başlığına ekleyin:

Authorization: Bearer API_ANAHTARINIZ

Uç Noktalar

YouTube'u MP3'e Dönüştür

POST /convert

Bir YouTube videosunu MP3 formatına dönüştürün.

Parametreler

Ad Tür Açıklama
url string YouTube video URL'si
quality string İsteğe bağlı. Ses kalitesi (yüksek, orta, düşük). Varsayılan: yüksek

Örnek İstek


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}")

Dönüştürme Durumunu Al

GET /status/{conversion_id}

Bir dönüştürme işinin durumunu kontrol edin.

Parametreler

Ad Tür Açıklama
conversion_id string Dönüştürme işinin ID'si

Örnek İstek


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}")

Toplu Dönüştürme

POST /batch-convert

Tek bir istekte birden fazla YouTube videosunu MP3 formatına dönüştürün.

Parametreler

Ad Tür Açıklama
urls array YouTube video URL'lerinin bir dizisi
quality string İsteğe bağlı. Ses kalitesi (yüksek, orta, düşük). Varsayılan: yüksek

Örnek İstek


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}")

Hız Sınırlaması

Adil kullanımı sağlamak ve hizmet kalitesini korumak için API'miz hız sınırlaması uygular. Mevcut sınırlar şunlardır:

Zaman Dilimi İstek Limiti
Dakika Başına 100 requests
Saat Başına 1,000 requests
Gün Başına 10,000 requests

Bu limitleri aşarsanız, 429 Çok Fazla İstek yanıtı alırsınız. Yanıt aşağıdaki başlıkları içerecektir:

  • X-RateLimit-Limit: O istek için hız limiti tavanı
  • X-RateLimit-Remaining: Zaman penceresi için kalan istek sayısı
  • X-RateLimit-Reset: Hız limitinin sıfırlanacağı kalan süre (UTC epoch saniyesi cinsinden)

Özel kullanım durumunuza uyarlanmış daha yüksek hız limitleri için lütfen satış ekibimizle iletişime geçin.

Hata İşleme

Açıklama

Kod Açıklama
200 OK İstek başarılı oldu.
400 Bad Request İstek geçersiz veya işlenemiyor. Tam hata, hata mesajında açıklanmıştır.
401 Unauthorized İstek kullanıcı kimlik doğrulaması gerektiriyor.
403 Forbidden Sunucu isteği anladı ancak yetkilendirmeyi reddediyor.
404 Not Found İstenen kaynak bulunamadı.
429 Too Many Requests Belirli bir süre içinde çok fazla istek gönderdiniz.
500 Internal Server Error Sunucumuzda bir sorun yaşadık. Daha sonra tekrar deneyin.

Tüm hata yanıtları, yanıt gövdesinde aşağıdaki yapıya sahip bir JSON nesnesi içerecektir:


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

Bu senaryoları düzgün bir şekilde yönetmek ve sorunsuz bir kullanıcı deneyimi sağlamak için uygulamanızda uygun hata işleme uygulamanızı öneririz.

API'miz ile Başlayın

Güçlü YouTube'dan MP3'e dönüştürme işlemini uygulamanıza entegre etmeye hazır mısınız?

Satış ile İletişime Geçin