Dokumentacja API

App.apiDescription

Rozpoczęcie pracy

Aby korzystać z API YTMP3CV.COM, będziesz potrzebować klucza API. Jeśli jeszcze go nie masz, skontaktuj się z nami, aby rozpocząć.

Wszystkie zapytania API powinny być kierowane do następującego podstawowego URL:

https://api.ytmp3cv.com/

Uwierzytelnianie

Dołącz swój klucz API w nagłówku wszystkich zapytań:

Authorization: Bearer TWÓJ_KLUCZ_API

Punkty końcowe

Konwertuj YouTube na MP3

POST /convert

Konwertuj film YouTube na format MP3.

Parametry

Nazwa Typ Opis
url string URL filmu YouTube
quality string Opcjonalnie. Jakość dźwięku (wysoka, średnia, niska). Domyślnie: wysoka

Przykładowe zapytanie


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

Sprawdź status konwersji

GET /status/{conversion_id}

Sprawdź status zadania konwersji.

Parametry

Nazwa Typ Opis
conversion_id string ID zadania konwersji

Przykładowe zapytanie


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

Konwersja wsadowa

POST /batch-convert

Konwertuj wiele filmów YouTube na format MP3 w jednym zapytaniu.

Parametry

Nazwa Typ Opis
urls array Tablica adresów URL filmów YouTube
quality string Opcjonalnie. Jakość dźwięku (wysoka, średnia, niska). Domyślnie: wysoka

Przykładowe zapytanie


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

Ograniczenia częstotliwości

Aby zapewnić uczciwe korzystanie i utrzymać jakość usługi, nasze API implementuje ograniczenia częstotliwości. Aktualne limity to:

Ramy czasowe Limit zapytań
Na minutę 100 requests
Na godzinę 1,000 requests
Na dzień 10,000 requests

Jeśli przekroczysz te limity, otrzymasz odpowiedź 429 Too Many Requests. Odpowiedź będzie zawierać następujące nagłówki:

  • X-RateLimit-Limit: Górny limit częstotliwości dla danego zapytania
  • X-RateLimit-Remaining: Liczba pozostałych zapytań dla danego okna czasowego
  • X-RateLimit-Reset: Pozostały czas przed zresetowaniem limitu częstotliwości w sekundach czasu UTC

Aby uzyskać wyższe limity częstotliwości dostosowane do Twoich konkretnych potrzeb, prosimy o kontakt z naszym zespoem sprzedaży.

Obsługa błędów

Opis

Kod Opis
200 OK Zapytanie zakończone sukcesem.
400 Bad Request Zapytanie było nieprawidłowe lub nie może być obsłużone. Dokładny błąd jest wyjaśniony w komunikacie o błędzie.
401 Unauthorized Zapytanie wymaga uwierzytelnienia użytkownika.
403 Forbidden Serwer zrozumiał zapytanie, ale odmawia jego autoryzacji.
404 Not Found Żądany zasób nie został znaleziony.
429 Too Many Requests Wysłałeś zbyt wiele zapytań w danym okresie czasu.
500 Internal Server Error Mieliśmy problem z naszym serwerem. Spróbuj ponownie później.

Wszystkie odpowiedzi błędów będą zawierać obiekt JSON w treści odpowiedzi o następującej strukturze:


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

Zalecamy implementację odpowiedniej obsługi błędów w Twojej aplikacji, aby elegancko zarządzać tymi scenariuszami i zapewnić płynne doświadczenie użytkownika.

Rozpocznij pracę z naszym API

Gotowy do integracji naszej potężnej konwersji YouTube do MP3 w swojej aplikacji?

Kontakt z działem sprzedaży