Como encurtar links pela API em PHP, Node e Python
Exemplo completo para encurtar links pelo seu sistema com a API grátis do curtei: criar a chave, chamar a API, tratar erros e evitar links duplicados.
Atualizado em 6 min de leitura
Resposta curta
Crie uma conta grátis no curtei, gere uma chave em Painel › Integrações e faça POST em /v1/links com o cabeçalho Authorization: Bearer <chave> e o JSON {"url": "..."}. A resposta traz short_url. A API é gratuita e não tem cota mensal.
1. Gere a chave
Em Painel › Integrações, crie uma chave com o escopo links:write. Guarde o token numa variável de ambiente (CURTEI_TOKEN), nunca no código.
2. Chame a API
Os exemplos em cURL, JavaScript, PHP e Python estão na referência de links. O essencial: POST /v1/links, corpo {"url": "..."}, cabeçalhos Authorization e Idempotency-Key.
3. Boas práticas
- Mande
Idempotency-Key(um UUID por link). Se a chamada der timeout e você repetir, não cria link duplicado. - Guarde o
iddo link no seu banco, ou envie o seu id emexternal_idpara buscar depois. - Trate
429esperando oRetry-Afterantes de tentar de novo. - Para muitos links de uma vez, use o lote: até 1.000 por chamada.
- Chame a API do servidor, nunca do navegador: o token daria acesso à sua conta.
Integrando com ajuda de IA
Cole o endereço /llms-full.txt do curtei no ChatGPT, Claude ou Cursor e descreva o que o seu sistema precisa. O arquivo tem toda a API em texto puro.
Teste agora
Crie uma conta grátis e veja os cliques dos seus links em tempo real.
Perguntas frequentes
A API do curtei é paga?
Não. A API faz parte da conta grátis. Há só limites de uso: 120 requisições por minuto e 1.000 links criados por hora.
Posso escolher o final do link pela API?
Sim, em domínio próprio, com o campo slug. No domínio compartilhado o código é sempre aleatório.