Referência da API

A Nayalink oferece uma API REST totalmente tipada. Tudo o que você pode fazer no painel — criar links curtos, gerenciar campanhas e tags e ler análises de cliques que respeitam a privacidade — está disponível de forma programática.

Para uma referência interativa onde você pode testar requisições no navegador, abra a referência interativa da API. O contrato legível por máquina é o documento OpenAPI.

URL base

Todos os endpoints são servidos a partir de https://api.nayalink.co.

Autenticação

Autentique-se com uma chave de API enviada como token Bearer:

Authorization: Bearer <your-api-key>

As chaves de API estão disponíveis nos planos Pro e Business e podem ser limitadas a permissões específicas. Gerencie-as em Configurações → Tokens de API.

Criar um link curto

Apenas original_url é obrigatório:

curl -X POST https://api.nayalink.co/api/v1/links \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"original_url": "https://example.com/very/long/url"}'

A resposta contém o código curto gerado e a URL curta completa.

Recursos

• Links — crie, atualize e gerencie links curtos: códigos personalizados, expiração, proteção por senha e regras de roteamento.
• Campanhas — agrupe links em campanhas e consolide as análises entre elas.
• Tags — organize os links com tags coloridas.
• Analytics — leia análises de cliques agregadas e que respeitam a privacidade: visitas ao longo do tempo, países, cidades, referenciadores, navegadores, sistemas operacionais, tipos de dispositivo, idiomas e parâmetros UTM. Nenhum endereço IP é armazenado.
• Tokens de API — crie e revogue chaves de API com escopo limitado.
• Perfil — leia e atualize a conta autenticada.

Próximos passos

• Teste requisições de forma interativa na referência da API.
• Novo na Nayalink? Comece pela introdução.