Documentație API

App.apiDescription

Începeți

Pentru a utiliza API-ul YTMP3CV.COM, veți avea nevoie de o cheie API. Dacă nu aveți încă una, contactați-ne pentru a începe.

Toate cererile API ar trebui făcute către următorul URL de bază:

https://api.ytmp3cv.com/

Autentificare

Includeți cheia dvs. API în antetul tuturor cererilor:

Authorization: Bearer CHEIA_DVS_API

Endpoint-uri

Convertiți YouTube în MP3

POST /convert

Convertiți un videoclip YouTube în format MP3.

Parametri

Nume Tip Descriere
url string URL-ul videoclipului YouTube
quality string Opțional. Calitatea audio (înaltă, medie, joasă). Implicit: înaltă

Exemplu de Cerere


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

Obțineți Statusul Conversiei

GET /status/{conversion_id}

Verificați statusul unei sarcini de conversie.

Parametri

Nume Tip Descriere
conversion_id string ID-ul sarcinii de conversie

Exemplu de Cerere


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

Conversie în Lot

POST /batch-convert

Convertiți mai multe videoclipuri YouTube în format MP3 într-o singură cerere.

Parametri

Nume Tip Descriere
urls array O matrice de URL-uri de videoclipuri YouTube
quality string Opțional. Calitatea audio (înaltă, medie, joasă). Implicit: înaltă

Exemplu de Cerere


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

Limitarea Ratei

Pentru a asigura o utilizare corectă și a menține calitatea serviciului, API-ul nostru implementează limitarea ratei. Limitele actuale sunt:

Interval de Timp Limită de Cereri
Pe Minut 100 requests
Pe Oră 1,000 requests
Pe Zi 10,000 requests

Dacă depășiți aceste limite, veți primi un răspuns 429 Too Many Requests. Răspunsul va include următoarele anteturi:

  • X-RateLimit-Limit: Plafonul limitei de rată pentru acea cerere dată
  • X-RateLimit-Remaining: Numărul de cereri rămase pentru fereastra de timp
  • X-RateLimit-Reset: Fereastra rămasă înainte ca limita de rată să se reseteze în secunde epoch UTC

Pentru limite de rată mai mari adaptate cazului dvs. specific de utilizare, vă rugăm să contactați echipa noastră de vânzări.

Gestionarea Erorilor

Descriere

Cod Descriere
200 OK Cererea a fost reușită.
400 Bad Request Cererea a fost invalidă sau nu poate fi servită. Eroarea exactă este explicată în mesajul de eroare.
401 Unauthorized Cererea necesită autentificarea utilizatorului.
403 Forbidden Serverul a înțeles cererea, dar refuză să o autorizeze.
404 Not Found Resursa solicitată nu a putut fi găsită.
429 Too Many Requests Ați trimis prea multe cereri într-o anumită perioadă de timp.
500 Internal Server Error Am avut o problemă cu serverul nostru. Încercați din nou mai târziu.

Toate răspunsurile de eroare vor include un obiect JSON în corpul răspunsului cu următoarea structură:


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

Vă recomandăm să implementați o gestionare adecvată a erorilor în aplicația dvs. pentru a gestiona cu grație aceste scenarii și a oferi o experiență fluidă utilizatorului.

Începeți cu API-ul Nostru

Sunteți gata să integrați conversia noastră puternică YouTube în MP3 în aplicația dvs.?

Contactați Vânzările