Документация API

App.apiDescription

Начало работы

Для использования API YTMP3CV.COM вам понадобится API-ключ. Если у вас его еще нет, свяжитесь с нами, чтобы начать.

Все запросы API должны быть отправлены на следующий базовый URL:

https://api.ytmp3cv.com/

Аутентификация

Включите ваш API-ключ в заголовок всех запросов:

Authorization: Bearer YOUR_API_KEY

Конечные точки

Конвертировать YouTube в MP3

POST /convert

Конвертировать видео YouTube в формат MP3.

Параметры

Имя Тип Описание
url string URL видео YouTube
quality string Необязательно. Качество аудио (high, medium, low). По умолчанию: high

Пример запроса


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

Получить статус конвертации

GET /status/{conversion_id}

Проверить статус задачи конвертации.

Параметры

Имя Тип Описание
conversion_id string ID задачи конвертации

Пример запроса


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

Пакетная конвертация

POST /batch-convert

Конвертировать несколько видео YouTube в формат MP3 в одном запросе.

Параметры

Имя Тип Описание
urls array Массив URL видео YouTube
quality string Необязательно. Качество аудио (high, medium, low). По умолчанию: high

Пример запроса


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

Ограничение скорости

Для обеспечения справедливого использования и поддержания качества обслуживания, наш API реализует ограничение скорости. Текущие ограничения:

Временной интервал Лимит запросов
В минуту 100 requests
В час 1,000 requests
В день 10,000 requests

Если вы превысите эти ограничения, вы получите ответ 429 Too Many Requests. Ответ будет включать следующие заголовки:

  • X-RateLimit-Limit: Верхний предел ограничения скорости для данного запроса
  • X-RateLimit-Remaining: Количество оставшихся запросов для временного окна
  • X-RateLimit-Reset: Оставшееся время до сброса ограничения скорости в секундах UTC epoch

Для более высоких ограничений скорости, адаптированных к вашему конкретному случаю использования, пожалуйста, свяжитесь с нашей командой продаж.

Обработка ошибок

Описание

Код Описание
200 OK Запрос выполнен успешно.
400 Bad Request Запрос недействителен или не может быть обслужен. Точная ошибка объясняется в сообщении об ошибке.
401 Unauthorized Запрос требует аутентификации пользователя.
403 Forbidden Сервер понял запрос, но отказывается его авторизовать.
404 Not Found Запрашиваемый ресурс не найден.
429 Too Many Requests Вы отправили слишком много запросов за определенное время.
500 Internal Server Error У нас возникла проблема с нашим сервером. Попробуйте позже.

Все ответы об ошибках будут включать объект JSON в теле ответа со следующей структурой:


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

Мы рекомендуем реализовать правильную обработку ошибок в вашем приложении для корректного управления этими сценариями и обеспечения плавного пользовательского опыта.

Начните работу с нашим API

Готовы интегрировать нашу мощную конвертацию YouTube в MP3 в ваше приложение?

Связаться с отделом продаж