API REST v1
Crie e leia links pelo seu próprio sistema
Disponível a partir do plano Pro. O token é gerado no painel, em API, e enviado no cabeçalho de autorização.
Autenticação
Todo endpoint (exceto /status) exige um token pessoal.
Authorization: Bearer lka_seu_token_aqui
Criar um link
curl -X POST https://linkalink.com.br/api/v1/links \
-H "Authorization: Bearer lka_seu_token_aqui" \
-H "Content-Type: application/json" \
-d '{
"titulo": "Campanha de julho",
"destino": "https://sualoja.com.br/promo",
"slug": "julho",
"utm": { "source": "instagram", "medium": "bio" }
}'
Endpoints
| Método | Rota | Descrição |
|---|---|---|
| GET | /api/v1/status | Verifica se a API responde. Não exige token. |
| GET | /api/v1/links | Lista os links da conta, paginados. |
| POST | /api/v1/links | Cria um link. Respeita o limite do plano. |
| GET | /api/v1/links/{id} | Detalha um link. |
| DELETE | /api/v1/links/{id} | Remove o link e todo o histórico dele. |
| GET | /api/v1/links/{id}/analytics | Métricas, séries por dia e o resumo do Link Intelligence. |
| POST | /api/v1/conversoes | Registra uma venda e amarra à origem do clique. |
| GET | /api/v1/links/{id}/conversoes | Conversões e receita por origem. |
Registrar uma conversão
Ao redirecionar, o Linkalink acrescenta lk_cid à URL de destino. Guarde esse
valor junto do pedido e devolva-o quando a venda se confirmar. É o que permite responder
qual canal traz receita, e não apenas qual traz clique.
curl -X POST https://linkalink.com.br/api/v1/conversoes \
-H "Authorization: Bearer lka_seu_token_aqui" \
-H "Content-Type: application/json" \
-d '{
"lk_cid": "valor_recebido_na_url",
"valor": 249.90,
"evento": "compra",
"id_externo": "pedido-10432"
}'
A chamada é servidor a servidor: não depende de cookie nem de JavaScript, e por isso
funciona também dentro do navegador do Instagram, onde pixel costuma falhar.
O campo id_externo torna o envio idempotente — repetir o mesmo pedido
devolve o registro original em vez de contar a venda duas vezes.
Códigos de resposta
| 200 / 201 | Requisição concluída. |
| 401 | Token ausente, inválido ou revogado. |
| 402 | Limite de links do plano atingido. |
| 403 | Plano sem acesso à API, ou conta inativa. |
| 409 | Slug já em uso. |
| 422 | Campos obrigatórios ausentes ou inválidos. |