Documentazione API

App.apiDescription

Iniziare

Per utilizzare l'API di YTMP3CV.COM, avrai bisogno di una chiave API. Se non ne hai ancora una, contattaci per iniziare.

Tutte le richieste API dovrebbero essere effettuate al seguente URL di base:

https://api.ytmp3cv.com/

Autenticazione

Includi la tua chiave API nell'header di tutte le richieste:

Authorization: Bearer LA_TUA_CHIAVE_API

Endpoint

Converti YouTube in MP3

POST /convert

Converti un video YouTube in formato MP3.

Parametri

Nome Tipo Descrizione
url string L'URL del video YouTube
quality string Opzionale. Qualità audio (alta, media, bassa). Predefinito: alta

Esempio di Richiesta


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

Ottieni Stato Conversione

GET /status/{conversion_id}

Controlla lo stato di un lavoro di conversione.

Parametri

Nome Tipo Descrizione
conversion_id string L'ID del lavoro di conversione

Esempio di Richiesta


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

Conversione in Batch

POST /batch-convert

Converti più video YouTube in formato MP3 in una singola richiesta.

Parametri

Nome Tipo Descrizione
urls array Un array di URL di video YouTube
quality string Opzionale. Qualità audio (alta, media, bassa). Predefinito: alta

Esempio di Richiesta


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

Limitazione della Velocità

Per garantire un uso equo e mantenere la qualità del servizio, la nostra API implementa la limitazione della velocità. I limiti attuali sono:

Intervallo di Tempo Limite di Richieste
Al Minuto 100 requests
All'Ora 1,000 requests
Al Giorno 10,000 requests

Se superi questi limiti, riceverai una risposta 429 Troppe Richieste. La risposta includerà i seguenti header:

  • X-RateLimit-Limit: Il limite massimo di velocità per quella determinata richiesta
  • X-RateLimit-Remaining: Il numero di richieste rimanenti per la finestra temporale
  • X-RateLimit-Reset: La finestra rimanente prima che il limite di velocità si resetti in secondi epoch UTC

Per limiti di velocità più elevati adattati al tuo caso d'uso specifico, contatta il nostro team vendite.

Gestione degli Errori

Descrizione

Codice Descrizione
200 OK La richiesta ha avuto successo.
400 Bad Request La richiesta non era valida o non può essere servita. L'errore esatto è spiegato nel messaggio di errore.
401 Unauthorized La richiesta richiede l'autenticazione dell'utente.
403 Forbidden Il server ha compreso la richiesta ma si rifiuta di autorizzarla.
404 Not Found La risorsa richiesta non è stata trovata.
429 Too Many Requests Hai inviato troppe richieste in un determinato periodo di tempo.
500 Internal Server Error Abbiamo avuto un problema con il nostro server. Riprova più tardi.

Tutte le risposte di errore includeranno un oggetto JSON nel corpo della risposta con la seguente struttura:


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

Raccomandiamo di implementare una corretta gestione degli errori nella tua applicazione per gestire elegantemente questi scenari e fornire un'esperienza utente fluida.

Inizia con la Nostra API

Pronto a integrare la nostra potente conversione da YouTube a MP3 nella tua applicazione?

Contatta Vendite