API e widget

Incorpore a busca com IA do LiKE em seus aplicativos, site ou sistemas internos. Três métodos de integração: API REST, widget JS, iframe.

#API REST

#Etapa 1 — Criar uma chave de API

1. Integrações → API pública → "Criar chave"
2. Insira um nome (por exemplo, "Aplicativo móvel")
3. Copie a chave — ela é exibida apenas uma vez

#Etapa 2 — Usar a API

Todas as solicitações são autorizadas via o cabeçalho:

X-API-Key: your-key

#Endpoints principais

#Exemplo: busca com IA

curl -X POST https://amedia.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Как оформить отпуск?"}'

Resposta:

{
  "answer": "Для оформления отпуска...",
  "sources": [
    {"title": "Политика отпусков", "url": "..."}
  ]
}

#Limites de taxa

As solicitações à API são limitadas por chave. O limite específico depende do seu plano; quando excedido, é retornado HTTP 429 com um cabeçalho Retry-After. Os valores exatos para o seu plano estão na seção do plano.

#Segurança

1. Armazene as chaves em variáveis de ambiente, não no código
2. Crie uma chave separada para cada aplicativo
3. Exclua as chaves não utilizadas
4. Restrinja os domínios nas configurações da chave

#Widget JS

Um botão flutuante de busca com IA para incorporar em qualquer site.

#Etapa 1 — Obter o código

1. Integrações → Widget JS
2. Configure os parâmetros (veja a tabela abaixo)
3. Copie o código

#Etapa 2 — Adicioná-lo ao seu site

Insira o <script> copiado antes da tag de fechamento </body>:

#Parâmetros do widget

#Resultado

Um botão roxo aparece no canto do seu site. Clique → uma janela modal com uma barra de busca → uma resposta da IA a partir da sua base de conhecimento.

#iframe

Uma interface de busca completa incorporada na sua página:

#Código de incorporação

#Link direto

Se um iframe não lhe convém, forneça aos usuários um link direto: https://amedia.lynkora.pro

#Modo de demonstração

Para testar sem uma chave de API, está disponível um endpoint de demonstração com limitações:

Endpoint: POST /api/public/demo/search

#Comparação dos modos de autenticação

O widget suporta dois modos de autenticação.

#Modo A — Confiar na zona da URL

Autenticação no lado do cliente: você é responsável por quem chega às páginas com o widget (VPN, SSO, rotas protegidas). A Lynkora não conhece a identidade do usuário — apenas o Origin/IP da solicitação. O widget é visível para todos que abrem uma página com o código de incorporação.

• Código de backend: 0 linhas
• Tempo de configuração: ~2 minutos
• Adequado para: intranet, portal interno

#Modo B — Token de sessão (JWT por usuário)

Seu backend emite um token de sessão de curta duração para cada usuário. A Lynkora conhece a identidade, mantém uma auditoria por usuário e suporta revogação e GDPR DSAR.

• Código de backend: ~10 linhas (via SDK)
• Tempo de configuração: 1–2 horas
• Adequado para: SaaS multi-tenant, setores regulamentados