Dokumentasi API

App.apiDescription

Memulai

Untuk menggunakan API YTMP3CV.COM, Anda akan membutuhkan kunci API. Jika Anda belum memilikinya, hubungi kami untuk memulai.

Semua permintaan API harus dilakukan ke URL dasar berikut:

https://api.ytmp3cv.com/

Autentikasi

Sertakan kunci API Anda di header semua permintaan:

Authorization: Bearer KUNCI_API_ANDA

Endpoint

Konversi YouTube ke MP3

POST /convert

Konversi video YouTube ke format MP3.

Parameter

Nama Tipe Deskripsi
url string URL video YouTube
quality string Opsional. Kualitas audio (tinggi, sedang, rendah). Default: 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 Konversi

GET /status/{conversion_id}

Periksa status pekerjaan konversi.

Parameter

Nama Tipe Deskripsi
conversion_id string ID pekerjaan konversi

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

Konversi Massal

POST /batch-convert

Konversi beberapa video YouTube ke format MP3 dalam satu permintaan.

Parameter

Nama Tipe Deskripsi
urls array Array URL video YouTube
quality string Opsional. Kualitas audio (tinggi, sedang, rendah). Default: 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}")

Pembatasan Laju

Untuk memastikan penggunaan yang adil dan mempertahankan kualitas layanan, API kami menerapkan pembatasan laju. Batas saat ini adalah:

Rentang Waktu Batas Permintaan
Per Menit 100 requests
Per Jam 1,000 requests
Per Hari 10,000 requests

Jika Anda melebihi batas ini, Anda akan menerima respons 429 Terlalu Banyak Permintaan. Respons akan menyertakan header berikut:

  • X-RateLimit-Limit: Batas atas laju untuk permintaan tersebut
  • X-RateLimit-Remaining: Jumlah permintaan yang tersisa untuk jendela waktu
  • X-RateLimit-Reset: Jendela waktu yang tersisa sebelum batas laju diatur ulang dalam detik epoch UTC

Untuk batas laju yang lebih tinggi yang disesuaikan dengan kasus penggunaan spesifik Anda, silakan hubungi tim penjualan kami.

Penanganan Kesalahan

Deskripsi

Kode Deskripsi
200 OK Permintaan berhasil.
400 Bad Request Permintaan tidak valid atau tidak dapat dilayani. Kesalahan yang tepat dijelaskan dalam pesan kesalahan.
401 Unauthorized Permintaan memerlukan autentikasi pengguna.
403 Forbidden Server memahami permintaan tetapi menolak untuk mengotorisasinya.
404 Not Found Sumber daya yang diminta tidak dapat ditemukan.
429 Too Many Requests Anda telah mengirim terlalu banyak permintaan dalam jumlah waktu tertentu.
500 Internal Server Error Kami mengalami masalah dengan server kami. Coba lagi nanti.

Semua respons kesalahan akan menyertakan objek JSON dalam badan respons dengan struktur berikut:


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

Kami merekomendasikan untuk menerapkan penanganan kesalahan yang tepat dalam aplikasi Anda untuk mengelola skenario ini dengan baik dan memberikan pengalaman pengguna yang lancar.

Mulai dengan API Kami

Siap untuk mengintegrasikan konversi YouTube ke MP3 yang kuat ke dalam aplikasi Anda?

Hubungi Penjualan