API pública

Encurte links e consulte estatísticas via API

A API gratuita do Diminua foi criada para integrações simples, testes rápidos e automações leves. Use sempre o host https://api.diminua.me.

Testar agora
Sem chave inicial O uso público é liberado sem token, protegido por rate limit por IP.
JSON simples Respostas padronizadas com success, data, error e meta.
Host dedicado Integrações devem chamar somente api.diminua.me.
Endpoint

Criar link curto

Cria um link curto aleatório no formato atual do Diminua.

POST https://api.diminua.me/api/v1/links/
Content-Type: application/json

{
  "url": "https://exemplo.com/minha-pagina"
}
{
  "success": true,
  "data": {
    "short_url": "https://diminua.me/N1ch",
    "slug": "N1ch",
    "original_url": "https://exemplo.com/minha-pagina"
  }
}
Endpoint

Consultar estatísticas

Consulta cliques totais, últimas 24 horas, últimos 7 dias e série diária recente.

GET https://api.diminua.me/api/v1/stats/N1ch/
GET https://api.diminua.me/api/v1/stats/?url=https://diminua.me/c/6gG
{
  "success": true,
  "data": {
    "short_url": "https://diminua.me/N1ch",
    "slug": "N1ch",
    "clicks": {
      "total": 20,
      "last_24h": 3,
      "last_7d": 12
    }
  }
}
Limites

Rate limit gratuito

20 encurtamentos por minuto por IP 120 consultas de estatísticas por minuto por IP Somente https://api.diminua.me

Os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset são enviados em todas as respostas da API.

Exemplo

cURL

curl -X POST https://api.diminua.me/api/v1/links/ \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"https://exemplo.com/minha-pagina\"}"
curl https://api.diminua.me/api/v1/stats/N1ch/
Erros

Códigos comuns

421 Use https://api.diminua.me 422 URL ou short URL inválida 429 Rate limit excedido 503 Tabela de rate limit indisponível
Sandbox

Encurtar uma URL

O resultado aparecerá aqui.
Sandbox

Consultar estatísticas

O resultado aparecerá aqui.