API-Dokumentation

App.apiDescription

Erste Schritte

Um die YTMP3CV.COM API zu nutzen, benötigen Sie einen API-Schlüssel. Wenn Sie noch keinen haben, kontaktieren Sie uns, um loszulegen.

Alle API-Anfragen sollten an die folgende Basis-URL gerichtet werden:

https://api.ytmp3cv.com/

Authentifizierung

Fügen Sie Ihren API-Schlüssel in den Header aller Anfragen ein:

Authorization: Bearer IHR_API_SCHLÜSSEL

Endpunkte

YouTube zu MP3 konvertieren

POST /convert

Konvertieren Sie ein YouTube-Video in das MP3-Format.

Parameter

Name Typ Beschreibung
url string Die YouTube-Video-URL
quality string Optional. Audioqualität (hoch, mittel, niedrig). Standard: hoch

Beispielanfrage


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

Konvertierungsstatus abrufen

GET /status/{conversion_id}

Überprüfen Sie den Status eines Konvertierungsauftrags.

Parameter

Name Typ Beschreibung
conversion_id string Die ID des Konvertierungsauftrags

Beispielanfrage


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

Stapelkonvertierung

POST /batch-convert

Konvertieren Sie mehrere YouTube-Videos in einer einzigen Anfrage in das MP3-Format.

Parameter

Name Typ Beschreibung
urls array Ein Array von YouTube-Video-URLs
quality string Optional. Audioqualität (hoch, mittel, niedrig). Standard: hoch

Beispielanfrage


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

Ratenbegrenzung

Um eine faire Nutzung zu gewährleisten und die Servicequalität aufrechtzuerhalten, implementiert unsere API eine Ratenbegrenzung. Die aktuellen Grenzen sind:

Zeitrahmen Anfragelimit
Pro Minute 100 requests
Pro Stunde 1,000 requests
Pro Tag 10,000 requests

Wenn Sie diese Grenzen überschreiten, erhalten Sie eine 429 Too Many Requests Antwort. Die Antwort enthält die folgenden Header:

  • X-RateLimit-Limit: Die Obergrenze der Ratenbegrenzung für diese Anfrage
  • X-RateLimit-Remaining: Die Anzahl der verbleibenden Anfragen für das Zeitfenster
  • X-RateLimit-Reset: Das verbleibende Fenster, bevor die Ratenbegrenzung in UTC-Epochensekunden zurückgesetzt wird

Für höhere Ratengrenzen, die auf Ihren spezifischen Anwendungsfall zugeschnitten sind, kontaktieren Sie bitte unser Vertriebsteam.

Fehlerbehandlung

Beschreibung

Code Beschreibung
200 OK Die Anfrage war erfolgreich.
400 Bad Request Die Anfrage war ungültig oder kann nicht bedient werden. Der genaue Fehler wird in der Fehlermeldung erklärt.
401 Unauthorized Die Anfrage erfordert Benutzerauthentifizierung.
403 Forbidden Der Server hat die Anfrage verstanden, weigert sich aber, sie zu autorisieren.
404 Not Found Die angeforderte Ressource konnte nicht gefunden werden.
429 Too Many Requests Sie haben zu viele Anfragen in einer bestimmten Zeit gesendet.
500 Internal Server Error Wir hatten ein Problem mit unserem Server. Versuchen Sie es später erneut.

Alle Fehlerantworten enthalten ein JSON-Objekt im Antworttext mit der folgenden Struktur:


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

Wir empfehlen, eine angemessene Fehlerbehandlung in Ihrer Anwendung zu implementieren, um diese Szenarien elegant zu bewältigen und eine reibungslose Benutzererfahrung zu gewährleisten.

Starten Sie mit unserer API

Bereit, unsere leistungsstarke YouTube-zu-MP3-Konvertierung in Ihre Anwendung zu integrieren?

Vertrieb kontaktieren