Alternativa à API do Bitly para Programadores: O Que Procurar

Se anda à procura de uma alternativa à API do Bitly, provavelmente já esbarrou numa de duas paredes: limites de taxa que restringem a sua automação no plano que consegue pagar, ou uma funcionalidade de que precisa a residir num escalão que não quer comprar. Este é um guia para programadores sobre o que realmente importa numa API de encurtador - limites, idempotência, webhooks, SDKs - e como funciona a mudança na prática.

Está no conjunto de engenharia. Para a estrutura dos pedidos e os fundamentos de autenticação que todas estas APIs partilham, o guia da API gratuita de encurtamento de URL é a base sobre a qual este artigo constrói.

Onde a API do Bitly Incomoda

A API do Bitly é capaz, e para uso de baixo volume é adequada. O atrito surge à escala. Os limites de taxa vão de cerca de 1.000 pedidos por mês nos escalões mais baixos até 150.000+ nos mais altos, com tetos por minuto e por hora sobrepostos, documentados na referência da API do Bitly. Num plano mais barato, esses tetos restringem exatamente os trabalhos automatizados para os quais uma API existe.

A segunda parede é a restrição por escalão. A estrutura de grupos e organizações, alguns endpoints de análises e volumes de chamadas mais elevados residem em escalões superiores, pelo que a versão da API que consegue justificar orçamentalmente muitas vezes não é a versão que a sua integração assumiu. Nenhuma das duas é exatamente uma falha - é assim que os preços foram construídos - mas ambas explicam porque é que as equipas começam a procurar. A própria análise da API do Bitly feita pela Rebrandly chega à mesma leitura sobre onde os limites apertam.

O Que Uma API de Encurtador Dev-First Deveria Oferecer

Retire a marca e uma boa API de encurtador resume-se a quatro coisas.

1. Limites de taxa com que se pode planear. Tetos documentados por janela, delimitados por workspace, que não sejam tão apertados nos escalões iniciais que um trabalho em lote os faça disparar. Previsível vence alto-mas-opaco.
2. Chaves de idempotência. Enviar uma chave estável por pedido lógico e uma nova tentativa após um timeout devolve o link original em vez de criar um duplicado. Sem isto, cada nova tentativa é um risco.
3. Webhooks. Enviar eventos de clique para o seu endpoint em vez de o obrigar a fazer polling a uma API de análises num temporizador.
4. SDKs verdadeiros. Bibliotecas oficiais nas linguagens que utiliza, para não ter de construir manualmente autenticação e paginação.

O aprofundamento sobre limites de taxa e idempotência explica porque é que o segundo ponto importa mais do que o teto de pedidos em bruto: uma API segura para repetições a 10.000 pedidos vence uma frágil a 100.000.

A Migração É Mais Pequena do Que Pensa (Exceto Uma Parte)

A chamada à API mal muda. A chamada de criação de links do Bitly e a maioria das alternativas têm a mesma forma: autenticar com um token bearer, fazer POST com um URL longo, ler o link curto do JSON. Trocar de fornecedor é, na maior parte, um novo URL base, um novo token e a correspondência dos nomes dos campos.

# Bitly
curl -X POST https://api-ssl.bitly.com/v4/shorten \
  -H "Authorization: Bearer $BITLY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"long_url": "https://example.com/page"}'

# Elido - mesma forma, mais uma chave de idempotência
curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Idempotency-Key: 5f3e-once" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/page"}'

Se estiver a chamá-la a partir de código, o tutorial em Python mostra os padrões de nova tentativa e idempotência a usar em qualquer uma das chamadas.

A parte que não é pequena: os seus links existentes. Um link curto só continua a funcionar se controlar o domínio onde vive. Links em bit.ly não podem ser movidos - esse domínio é do Bitly. Só os links de marca no seu próprio domínio podem ser redirecionados para um novo fornecedor sem se partirem. Por isso, a pergunta real da migração é "quantos dos meus links ativos estão num domínio que possuo?" - e a resposta decide o quão limpa é a mudança. O manual de migração do Bitly percorre os passos de domínio e redirecionamento.

Escolher Uma

A lista honesta para uma API de programador é Short.io, Rebrandly, Dub e Elido - cada um expõe uma API real com SDKs. O Short.io e o Dub apostam em programadores pelo preço; o Rebrandly aposta na automação de domínios de marca. Onde o Elido difere é na combinação que os outros não colocam no centro: idempotência e webhooks por defeito, mais residência de dados na UE, de forma que os dados de cliques fiquem na região da UE em vez de serem transferidos para fora. Se o seu stack tem uma linha de conformidade além de uma linha técnica, essa combinação é a razão para o considerar - e pode construir contra a API no plano gratuito para testar o ajuste antes de se comprometer.

Seja qual for a sua escolha, avalie-a pelos limites e pela idempotência, não pelo marketing. São essas as duas coisas que decidem se a sua integração é aborrecida e fiável ou uma fonte de alertas às 2 da manhã.

Leia a Série Principal

Este artigo está no conjunto de engenharia. Comece pelo guia da API gratuita de encurtamento de URL, depois o aprofundamento sobre limites de taxa e idempotência. A referência ao vivo é a documentação da API.

Artigos Relacionados no Blog

• API gratuita de encurtamento de URL: a estrutura dos pedidos, autenticação e limites
• Limites de taxa e idempotência da API de encurtador de URL
• Como encurtar um URL em Python
• O guia de alternativas ao Bitly por lacunas de funcionalidades
• Migrar do Bitly: o manual