Documentação da API

App.apiDescription

Começando

Para usar a API do YTMP3CV.COM, você precisará de uma chave de API. Se ainda não tiver uma, entre em contato conosco para começar.

Todas as solicitações de API devem ser feitas para a seguinte URL base:

https://api.ytmp3cv.com/

Autenticação

Inclua sua chave de API no cabeçalho de todas as solicitações:

Authorization: Bearer SUA_CHAVE_DE_API

Endpoints

Converter YouTube para MP3

POST /convert

Converta um vídeo do YouTube para o formato MP3.

Parâmetros

Nome Tipo Descrição
url string A URL do vídeo do YouTube
quality string Opcional. Qualidade do áudio (alta, média, baixa). Padrão: alta

Exemplo de Solicitação


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

Obter Status da Conversão

GET /status/{conversion_id}

Verifique o status de um trabalho de conversão.

Parâmetros

Nome Tipo Descrição
conversion_id string O ID do trabalho de conversão

Exemplo de Solicitação


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

Conversão em Lote

POST /batch-convert

Converta vários vídeos do YouTube para o formato MP3 em uma única solicitação.

Parâmetros

Nome Tipo Descrição
urls array Uma matriz de URLs de vídeos do YouTube
quality string Opcional. Qualidade do áudio (alta, média, baixa). Padrão: alta

Exemplo de Solicitação


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

Limitação de Taxa

Para garantir o uso justo e manter a qualidade do serviço, nossa API implementa limitação de taxa. Os limites atuais são:

Intervalo de Tempo Limite de Solicitações
Por Minuto 100 requests
Por Hora 1,000 requests
Por Dia 10,000 requests

Se você exceder esses limites, receberá uma resposta 429 Too Many Requests. A resposta incluirá os seguintes cabeçalhos:

  • X-RateLimit-Limit: O limite máximo de taxa para essa solicitação específica
  • X-RateLimit-Remaining: O número de solicitações restantes para a janela de tempo
  • X-RateLimit-Reset: A janela restante antes que o limite de taxa seja redefinido em segundos de época UTC

Para limites de taxa mais altos adaptados ao seu caso de uso específico, entre em contato com nossa equipe de vendas.

Tratamento de Erros

Descrição

Código Descrição
200 OK A solicitação foi bem-sucedida.
400 Bad Request A solicitação era inválida ou não pôde ser atendida. O erro exato é explicado na mensagem de erro.
401 Unauthorized A solicitação requer autenticação do usuário.
403 Forbidden O servidor entendeu a solicitação, mas se recusa a autorizá-la.
404 Not Found O recurso solicitado não pôde ser encontrado.
429 Too Many Requests Você enviou muitas solicitações em um determinado período de tempo.
500 Internal Server Error Tivemos um problema com nosso servidor. Tente novamente mais tarde.

Todas as respostas de erro incluirão um objeto JSON no corpo da resposta com a seguinte estrutura:


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

Recomendamos implementar o tratamento adequado de erros em sua aplicação para gerenciar graciosamente esses cenários e fornecer uma experiência de usuário suave.

Comece com Nossa API

Pronto para integrar nossa poderosa conversão de YouTube para MP3 em sua aplicação?

Contatar Vendas