Este artigo contém as práticas recomendadas para interagir com a API do Vimeo e utilizá-la.
Neste artigo, saiba mais sobre:
- Respostas em cache
- Usar filtros de campo
- Respeite os limites de taxa
- Evite o web scraping
- Use apenas nossas APIs publicamente documentadas
Respostas em cache
A maioria dos metadados no Vimeo não muda com frequência (como nomes de vídeos, descrições, código de incorporação etc.). Sempre que possível, os desenvolvedores devem armazenar essas respostas em cache e utilizá-las fazendo solicitações à API somente quando novos metadados são necessários ou esperados. A implementação de parâmetros como o cabeçalho Se-Modificado-Desde pode ajudar nessa área. Saiba mais em “Usando o cabeçalho Se-Modificado-Desde” em nossa Página de desenvolvedor.
Usar filtros de campo
Muitas solicitações ao Vimeo retornarão uma grande quantidade de dados, o que pode não ser eficiente se você precisar apenas de uma informação específica. Usar o parâmetro campos para especificar exatamente o que você precisa da resposta reduzirá a carga de trabalho em nossos servidores e aumentará o tempo de resposta da API. Saiba mais em “Usando o parâmetro campos”. O uso do parâmetro campos também concederá um limite de taxa maior.
Respeite os limites de taxa
Impomos limites de taxas para ajudar a garantir uma plataforma estável para todos os desenvolvedores. Se seu aplicativo exceder o limite de taxa, a API retornará um erro HTTP 429. Os desenvolvedores devem antecipar isso e parar de fazer solicitações à API até que a proibição do limite de taxa seja suspensa. Saiba mais em “Trabalhando com limites de taxa”.
Evite o web scraping
Web scraping é a ação de extrair dados de um site, muitas vezes carregando uma página e executando um script para obter os dados desejados dela.
Em vez de fazer scraping para obter dados, os desenvolvedores devem utilizar uma de nossas APIs para obter os mesmos dados; implementar nossa API é mais fácil e rápido do que fazer web scraping no site.
Se um servidor for encontrado capturando o Vimeo e enviando tráfego excessivo em nossa direção, o endereço IP desse servidor poderá ser banido sem aviso prévio. Se você acredita que o endereço IP do seu servidor foi banido, entre em contato com o Suporte com informações adicionais.
Use apenas nossas APIs publicamente documentadas
Desenvolvedores audaciosos podem descobrir meta tags, arquivos de configuração ou outras APIs usadas para obter dados do Vimeo. Embora possam ser acessíveis a usuários experientes, pedimos que os desenvolvedores utilizem apenas as APIs públicas documentadas no Site do Desenvolvedor. Essas APIs internas não se destinam ao uso de terceiros e podem mudar a qualquer momento sem aviso prévio.