CHRX Link

Encurtador de links — https://link.chrx.com.br

API REST para criar e gerenciar links curtos. Todas as rotas de gerenciamento exigem autenticação via header X-API-Key.

Autenticação

Envie a chave de API em todas as requisições protegidas:

X-API-Key: sua-api-key

Ou via Bearer token:

Authorization: Bearer sua-api-key

Endpoints

POST /api/links

Cria um link encurtado.

Body (JSON):

{
  "url": "https://exemplo.com/pagina",
  "code": "meu-link"   // opcional — slug personalizado
}

Resposta 201:

{
  "code": "meu-link",
  "url": "https://exemplo.com/pagina",
  "shortUrl": "https://link.chrx.com.br/meu-link",
  "clicks": 0,
  "createdAt": "2026-07-15T21:00:00.000Z"
}

GET /api/links Auth

Lista todos os links. Query params: limit (max 100), offset.

curl -H "X-API-Key: sua-api-key" \
  "https://link.chrx.com.br/api/links?limit=20"

GET /api/links/:code Auth

Retorna detalhes de um link específico.

curl -H "X-API-Key: sua-api-key" \
  "https://link.chrx.com.br/api/links/meu-link"

DELETE /api/links/:code Auth

Remove um link.

curl -X DELETE -H "X-API-Key: sua-api-key" \
  "https://link.chrx.com.br/api/links/meu-link"

GET /:code

Redireciona para a URL original (302). Público, sem autenticação.

https://link.chrx.com.br/meu-link  →  redirect para URL original

Exemplo completo

curl -X POST https://link.chrx.com.br/api/links \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sua-api-key" \
  -d '{"url": "https://chrx.com.br"}'

Códigos de erro

400  Requisição inválida (URL ou código malformado)
401  API key inválida ou ausente
404  Link não encontrado
409  Código já em uso
500  Erro interno