Tài liệu API

App.apiDescription

Bắt đầu

Để sử dụng API YTMP3CV.COM, bạn sẽ cần một khóa API. Nếu bạn chưa có, liên hệ với chúng tôi để bắt đầu.

Tất cả các yêu cầu API nên được gửi đến URL cơ sở sau:

https://api.ytmp3cv.com/

Xác thực

Bao gồm khóa API của bạn trong tiêu đề của tất cả các yêu cầu:

Authorization: Bearer YOUR_API_KEY

Điểm cuối

Chuyển đổi YouTube sang MP3

POST /convert

Chuyển đổi video YouTube sang định dạng MP3.

Tham số

Tên Loại Mô tả
url string URL video YouTube
quality string Tùy chọn. Chất lượng âm thanh (cao, trung bình, thấp). Mặc định: cao

Ví dụ yêu cầu


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

Kiểm tra trạng thái chuyển đổi

GET /status/{conversion_id}

Kiểm tra trạng thái của một công việc chuyển đổi.

Tham số

Tên Loại Mô tả
conversion_id string ID của công việc chuyển đổi

Ví dụ yêu cầu


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

Chuyển đổi hàng loạt

POST /batch-convert

Chuyển đổi nhiều video YouTube sang định dạng MP3 trong một yêu cầu duy nhất.

Tham số

Tên Loại Mô tả
urls array Một mảng các URL video YouTube
quality string Tùy chọn. Chất lượng âm thanh (cao, trung bình, thấp). Mặc định: cao

Ví dụ yêu cầu


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

Giới hạn tốc độ

Để đảm bảo sử dụng công bằng và duy trì chất lượng dịch vụ, API của chúng tôi thực hiện giới hạn tốc độ. Các giới hạn hiện tại là:

Khung thời gian Giới hạn yêu cầu
Mỗi phút 100 requests
Mỗi giờ 1,000 requests
Mỗi ngày 10,000 requests

Nếu bạn vượt quá các giới hạn này, bạn sẽ nhận được phản hồi 429 Too Many Requests. Phản hồi sẽ bao gồm các tiêu đề sau:

  • X-RateLimit-Limit: Giới hạn tốc độ cho yêu cầu đó
  • X-RateLimit-Remaining: Số lượng yêu cầu còn lại cho cửa sổ thời gian
  • X-RateLimit-Reset: Cửa sổ còn lại trước khi giới hạn tốc độ được đặt lại trong giây epoch UTC

Để có giới hạn tốc độ cao hơn phù hợp với trường hợp sử dụng cụ thể của bạn, vui lòng liên hệ với đội ngũ bán hàng của chúng tôi.

Xử lý lỗi

Mô tả

Mã Mô tả
200 OK Yêu cầu thành công.
400 Bad Request Yêu cầu không hợp lệ hoặc không thể được phục vụ. Lỗi chính xác được giải thích trong thông báo lỗi.
401 Unauthorized Yêu cầu cần xác thực người dùng.
403 Forbidden Máy chủ đã hiểu yêu cầu nhưng từ chối ủy quyền nó.
404 Not Found Không tìm thấy tài nguyên được yêu cầu.
429 Too Many Requests Bạn đã gửi quá nhiều yêu cầu trong một khoảng thời gian nhất định.
500 Internal Server Error Chúng tôi gặp sự cố với máy chủ của mình. Hãy thử lại sau.

Tất cả các phản hồi lỗi sẽ bao gồm một đối tượng JSON trong phần thân phản hồi với cấu trúc sau:


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

Chúng tôi khuyên bạn nên triển khai xử lý lỗi thích hợp trong ứng dụng của bạn để quản lý các kịch bản này một cách nhẹ nhàng và cung cấp trải nghiệm người dùng suôn sẻ.

Bắt đầu với API của chúng tôi

Sẵn sàng tích hợp chuyển đổi YouTube sang MP3 mạnh mẽ vào ứng dụng của bạn?

Liên hệ bộ phận bán hàng