API Documentatie

App.apiDescription

Aan de slag

Om de YTMP3CV.COM API te gebruiken, heb je een API-sleutel nodig. Als je er nog geen hebt, neem dan contact met ons op om te beginnen.

Alle API-verzoeken moeten worden gedaan naar de volgende basis-URL:

https://api.ytmp3cv.com/

Authenticatie

Voeg je API-sleutel toe aan de header van alle verzoeken:

Authorization: Bearer JOUW_API_SLEUTEL

Eindpunten

Converteer YouTube naar MP3

POST /convert

Converteer een YouTube-video naar MP3-formaat.

Parameters

Naam Type Beschrijving
url string De YouTube-video-URL
quality string Optioneel. Audiokwaliteit (hoog, gemiddeld, laag). Standaard: hoog

Voorbeeld Verzoek


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

Krijg Conversiestatus

GET /status/{conversion_id}

Controleer de status van een conversietaak.

Parameters

Naam Type Beschrijving
conversion_id string De ID van de conversietaak

Voorbeeld Verzoek


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

Batchconversie

POST /batch-convert

Converteer meerdere YouTube-video's naar MP3-formaat in één verzoek.

Parameters

Naam Type Beschrijving
urls array Een array van YouTube-video-URL's
quality string Optioneel. Audiokwaliteit (hoog, gemiddeld, laag). Standaard: hoog

Voorbeeld Verzoek


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

Snelheidsbeperking

Om eerlijk gebruik te garanderen en de servicekwaliteit te behouden, implementeert onze API snelheidsbeperkingen. De huidige limieten zijn:

Tijdsbestek Verzoeklimiet
Per Minuut 100 requests
Per Uur 1,000 requests
Per Dag 10,000 requests

Als je deze limieten overschrijdt, ontvang je een 429 Te Veel Verzoeken reactie. De reactie zal de volgende headers bevatten:

  • X-RateLimit-Limit: De snelheidslimiet voor dat specifieke verzoek
  • X-RateLimit-Remaining: Het aantal resterende verzoeken voor het tijdsvenster
  • X-RateLimit-Reset: Het resterende venster voordat de snelheidslimiet wordt gereset in UTC epoch seconden

Voor hogere snelheidslimieten op maat van jouw specifieke gebruikssituatie, neem contact op met ons verkoopteam.

Foutafhandeling

Beschrijving

Code Beschrijving
200 OK Het verzoek was succesvol.
400 Bad Request Het verzoek was ongeldig of kan niet worden verwerkt. De exacte fout wordt uitgelegd in het foutbericht.
401 Unauthorized Het verzoek vereist gebruikersauthenticatie.
403 Forbidden De server begreep het verzoek maar weigert het te autoriseren.
404 Not Found De gevraagde bron kon niet worden gevonden.
429 Too Many Requests Je hebt te veel verzoeken verzonden in een bepaalde hoeveelheid tijd.
500 Internal Server Error We hadden een probleem met onze server. Probeer het later opnieuw.

Alle foutreacties bevatten een JSON-object in de reactiebody met de volgende structuur:


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

We raden aan om goede foutafhandeling in je applicatie te implementeren om deze scenario's netjes te beheren en een soepele gebruikerservaring te bieden.

Aan de slag met Onze API

Klaar om onze krachtige YouTube naar MP3 conversie in je applicatie te integreren?

Contact Verkoop