Programadores
Constrói sobre o Linktotem
Uma API REST para todas as páginas de uma conta: perfis, páginas, blocos, design, audiência e estatísticas. Feita para agências com muitas páginas e para tudo o que quiseres automatizar.
O que podes fazer
Perfis
Listar, criar, renomear e apagar as páginas de uma conta, com a mesma quota do painel.
Blocos
Acrescentar links, títulos, texto, ícones sociais, media e pastas; alterá-los, esconder e reordenar uma página inteira.
Design
Ler o tema de um perfil e substituí-lo: cores, tipos de letra, fundo, botões, cabeçalho.
Audiência
Ir buscar respostas de formulários e subscritores com `since=` e levá-los para o teu CRM.
Números
Visitas, cliques, canais e países para qualquer período, e uma fotografia da página publicada.
curl https://linktotem.com/api/v1/profiles \
-H "Authorization: Bearer app_live_…"const res = await fetch("https://linktotem.com/api/v1/profiles/" + id + "/blocks", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.LINKTOTEM_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "link",
payload: {
title: "New episode",
destination: { type: "url", value: "https://example.com/ep-42" },
},
}),
});
const block = await res.json();Endpoints
Está tudo debaixo de https://linktotem.com/api/v1. A referência tem todos os campos, todos os erros e uma consola para experimentar.
- GET/profilesTodos os perfis da conta.
- POST/profilesUm perfil novo, dentro da quota do plano.
- GET/profiles/{id}/pagesAs páginas de um perfil.
- GET/profiles/{id}/blocksOs blocos de uma página, por ordem.
- POST/profiles/{id}/blocksAcrescentar um bloco a uma página.
- PATCH/blocks/{id}Alterar um bloco; um bloco nunca muda de tipo.
- POST/profiles/{id}/blocks/reorderReordenar uma página inteira num só pedido.
- PATCH/profiles/{id}/stylesSubstituir o tema de um perfil.
- GET/profiles/{id}/submissionsRespostas de formulários, as mais recentes primeiro.
- GET/profiles/{id}/subscribersSubscritores, os mais recentes primeiro.
- GET/profiles/{id}/analyticsVisitas e cliques por dias inteiros (UTC).
- GET/profiles/{id}/screenshotUm JPEG da página publicada.
Bom saber
- As chaves criam-se em Definições › API, são mostradas uma só vez e são de leitura ou de escrita. Pertencem a uma conta e chegam a todos os perfis dela.
- 120 pedidos por minuto por chave, dos quais 30 podem alterar alguma coisa. Acima disso recebes um 429 que diz quanto tempo esperar.
- As escritas passam pela mesma validação e pelas mesmas verificações de segurança do editor, e a página pública é reconstruída antes de a resposta chegar. Não há rascunhos: uma alteração fica logo no ar.
- Não há plano à parte para programadores: a API faz parte do Pro, com os perfis que já pagas.
Começa com uma chave
Cria conta, vai a Definições › API e faz a primeira chave. A referência passa logo a funcionar com ela.