Dokumentasi API

App.apiDescription

Memulakan

Untuk menggunakan API YTMP3CV.COM, anda memerlukan kunci API. Jika anda belum mempunyainya, hubungi kami untuk bermula.

Semua permintaan API harus dibuat ke URL asas berikut:

https://api.ytmp3cv.com/

Pengesahan

Sertakan kunci API anda dalam pengepala semua permintaan:

Authorization: Bearer KUNCI_API_ANDA

Titik Akhir

Tukar YouTube ke MP3

POST /convert

Tukar video YouTube ke format MP3.

Parameter

Nama Jenis Penerangan
url string URL video YouTube
quality string Pilihan. Kualiti audio (tinggi, sederhana, rendah). Lalai: tinggi

Contoh Permintaan


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

Dapatkan Status Penukaran

GET /status/{conversion_id}

Periksa status kerja penukaran.

Parameter

Nama Jenis Penerangan
conversion_id string ID kerja penukaran

Contoh Permintaan


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

Penukaran Berkelompok

POST /batch-convert

Tukar pelbagai video YouTube ke format MP3 dalam satu permintaan.

Parameter

Nama Jenis Penerangan
urls array Tatasusunan URL video YouTube
quality string Pilihan. Kualiti audio (tinggi, sederhana, rendah). Lalai: tinggi

Contoh Permintaan


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

Had Kadar

Untuk memastikan penggunaan yang adil dan mengekalkan kualiti perkhidmatan, API kami melaksanakan had kadar. Had semasa adalah:

Rangka Masa Had Permintaan
Setiap Minit 100 requests
Setiap Jam 1,000 requests
Setiap Hari 10,000 requests

Jika anda melebihi had ini, anda akan menerima respons 429 Terlalu Banyak Permintaan. Respons akan merangkumi pengepala berikut:

  • X-RateLimit-Limit: Siling had kadar untuk permintaan tersebut
  • X-RateLimit-Remaining: Bilangan permintaan yang tinggal untuk tetingkap masa
  • X-RateLimit-Reset: Tetingkap yang tinggal sebelum had kadar ditetapkan semula dalam saat epoch UTC

Untuk had kadar yang lebih tinggi yang disesuaikan dengan kes penggunaan khusus anda, sila hubungi pasukan jualan kami.

Pengendalian Ralat

Penerangan

Kod Penerangan
200 OK Permintaan berjaya.
400 Bad Request Permintaan tidak sah atau tidak dapat dilayan. Ralat yang tepat dijelaskan dalam mesej ralat.
401 Unauthorized Permintaan memerlukan pengesahan pengguna.
403 Forbidden Pelayan memahami permintaan tetapi enggan mengizinkannya.
404 Not Found Sumber yang diminta tidak dapat ditemui.
429 Too Many Requests Anda telah menghantar terlalu banyak permintaan dalam jumlah masa tertentu.
500 Internal Server Error Kami mengalami masalah dengan pelayan kami. Cuba lagi nanti.

Semua respons ralat akan merangkumi objek JSON dalam badan respons dengan struktur berikut:


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

Kami mengesyorkan untuk melaksanakan pengendalian ralat yang betul dalam aplikasi anda untuk menguruskan senario ini dengan baik dan memberikan pengalaman pengguna yang lancar.

Mulakan dengan API Kami

Bersedia untuk mengintegrasikan penukaran YouTube ke MP3 yang berkuasa ke dalam aplikasi anda?

Hubungi Jualan