Documentation API

App.apiDescription

Commencer

Pour utiliser l'API YTMP3CV.COM, vous aurez besoin d'une clé API. Si vous n'en avez pas encore, contactez-nous pour commencer.

Toutes les requêtes API doivent être faites à l'URL de base suivante :

https://api.ytmp3cv.com/

Authentification

Incluez votre clé API dans l'en-tête de toutes les requêtes :

Authorization: Bearer VOTRE_CLÉ_API

Points de Terminaison

Convertir YouTube en MP3

POST /convert

Convertir une vidéo YouTube au format MP3.

Paramètres

Nom Type Description
url string L'URL de la vidéo YouTube
quality string Optionnel. Qualité audio (haute, moyenne, basse). Par défaut : haute

Exemple de Requête


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

Obtenir le Statut de Conversion

GET /status/{conversion_id}

Vérifier le statut d'une tâche de conversion.

Paramètres

Nom Type Description
conversion_id string L'ID de la tâche de conversion

Exemple de Requête


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

Conversion par Lots

POST /batch-convert

Convertir plusieurs vidéos YouTube au format MP3 en une seule requête.

Paramètres

Nom Type Description
urls array Un tableau d'URLs de vidéos YouTube
quality string Optionnel. Qualité audio (haute, moyenne, basse). Par défaut : haute

Exemple de Requête


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

Limitation de Débit

Pour assurer une utilisation équitable et maintenir la qualité du service, notre API implémente une limitation de débit. Les limites actuelles sont :

Période Limite de Requêtes
Par Minute 100 requests
Par Heure 1,000 requests
Par Jour 10,000 requests

Si vous dépassez ces limites, vous recevrez une réponse 429 Too Many Requests. La réponse inclura les en-têtes suivants :

  • X-RateLimit-Limit: Le plafond de limite de débit pour cette requête donnée
  • X-RateLimit-Remaining: Le nombre de requêtes restantes pour la fenêtre de temps
  • X-RateLimit-Reset: La fenêtre restante avant que la limite de débit ne se réinitialise en secondes d'époque UTC

Pour des limites de débit plus élevées adaptées à votre cas d'utilisation spécifique, veuillez contacter notre équipe commerciale.

Gestion des Erreurs

Description

Code Description
200 OK La requête a réussi.
400 Bad Request La requête était invalide ou ne peut pas être servie. L'erreur exacte est expliquée dans le message d'erreur.
401 Unauthorized La requête nécessite une authentification de l'utilisateur.
403 Forbidden Le serveur a compris la requête mais refuse de l'autoriser.
404 Not Found La ressource demandée n'a pas pu être trouvée.
429 Too Many Requests Vous avez envoyé trop de requêtes dans un laps de temps donné.
500 Internal Server Error Nous avons eu un problème avec notre serveur. Réessayez plus tard.

Toutes les réponses d'erreur incluront un objet JSON dans le corps de la réponse avec la structure suivante :


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

Nous recommandons d'implémenter une gestion appropriée des erreurs dans votre application pour gérer gracieusement ces scénarios et fournir une expérience utilisateur fluide.

Commencez avec Notre API

Prêt à intégrer notre puissante conversion YouTube vers MP3 dans votre application ?

Contacter les Ventes