Encurtador de URLs · Singus

Links que
chegam.

Transforme qualquer URL longa em um endereço limpo, rastreável e com validade controlada. API REST simples, multi-tenant e integrada nativamente com os sistemas Singus.

Ver a API Recursos

lnk.singus — demonstração ao vivo

URL original

↓

lnk.singus.app.br/s/—

● aguardando sistema: — 0 cliques

Tudo que você
precisa

⚡

Criação instantânea

Gere um link curto com um único POST. Idempotência por contexto: o mesmo context_type + context_id retorna sempre o mesmo código.

POST /api/urls

⋮⋮

Criação em lote

Processe até 100 URLs em uma única requisição com resposta HTTP 207 e status individual por item.

POST /api/urls/batch

🏢

Multi-tenant nativo

Isolamento completo por empresa e cliente. Cada URL pertence a uma organização — sem vazamento entre tenants.

co_empresa + co_cliente

Invalidação controlada

Desative um link a qualquer momento sem deletar registros. Status muda para inactive — totalmente auditável.

POST /api/urls/:code/invalidate

📊

Estatísticas em tempo real

Contagem de cliques incrementada a cada acesso. Endpoint de stats globais e por empresa via API.

GET /api/stats

🔒

Autenticação por API Key

Chave exclusiva por sistema integrado. Controle granular de acesso via header X-Api-Key.

X-Api-Key: <chave>

API simples
como deve ser

Autentique

Inclua o header X-Api-Key com a chave do seu sistema em toda requisição protegida. Cada sistema tem sua chave exclusiva.

Crie o link

Envie a URL original com o contexto de negócio (empresa, cliente, tipo). Receba o código curto de 8 chars gerado com nanoid.

Distribua

Use lnk.singus.app.br/s/:code onde precisar — PDFs, QR Codes, e-mails. O redirect 301 acontece com rastreamento automático de cliques.

// POST /api/urls
fetch('https://lnk.singus.app.br/api/urls', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': 'sua-api-key'
  },
  body: JSON.stringify({
    url: 'https://epatrimonio.singus.app.br/relatorio/...',
    co_empresa: 1,
    co_cliente: 42,
    context_type: 'relatorio',
    context_id: 99
  })
})

// POST /api/urls/batch — até 100 itens
fetch('https://lnk.singus.app.br/api/urls/batch', {
  method: 'POST',
  headers: { 'X-Api-Key': 'sua-api-key' },
  body: JSON.stringify({
    urls: [
      { url: 'https://exemplo.com/pag-1', co_empresa: 1, co_cliente: 42 },
      { url: 'https://exemplo.com/pag-2', co_empresa: 1, co_cliente: 42 }
      // ... até 100 itens
    ]
  })
})
// Retorna HTTP 207 com status por item

// GET /api/resolve/:code — metadados sem redirect
fetch('https://lnk.singus.app.br/api/resolve/Ab3xY7Zq', {
  headers: { 'X-Api-Key': 'sua-api-key' }
})

// Redirect público (sem API Key):
// GET /s/Ab3xY7Zq → 301 → URL original

// Invalidar um link:
fetch('/api/urls/Ab3xY7Zq/invalidate', {
  method: 'POST',
  headers: { 'X-Api-Key': 'sua-api-key' }
})

// HTTP 201 Created
{
  "code": "Ab3xY7Zq",
  "short_url": "https://lnk.singus.app.br/s/Ab3xY7Zq",
  "url_original": "https://epatrimonio.singus...",
  "co_empresa": 1,
  "co_cliente": 42,
  "context_type": "relatorio",
  "context_id": 99,
  "status": "active",
  "clicks": 0,
  "expires_at": null,
  "created_at": "2025-01-15T14:23:00.000Z"
}

Sistemas
integrados

e-Patrimônio

Gestão patrimonial. URLs de relatórios, fichas e documentos encurtadas para QR Codes e impressos.

API_KEY_EPATRIMONIO

e-GED

Gestão eletrônica de documentos. Links de acesso a arquivos e pastas com rastreamento de abertura.

API_KEY_EGED

e-Saúde

Saúde digital. Links de prontuários, laudos e agendamentos com validade e rastreamento controlados.

API_KEY_ESAUDE

Admin

Acesso administrativo com privilégios elevados para gestão, auditoria e operações transversais.

API_KEY_ADMIN

Links quechegam.

Tudo que vocêprecisa