Authorization: Bearer <token-de-sessão>
X-Asender-Tenant: <slug-da-conta-ativa>

{ "erro": "já existe uma página no endereço \"promo\"" }

{ "error": { "message": "credencial ausente ou inválida" } }

# 1) criar a página
curl -X POST 'https://api.pages.asender.net/v1/paginas' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{ "titulo": "Lançamento", "slug": "promo" }'
# → 201 { "id": "…", "slug": "promo", "titulo": "Lançamento", … }

# 2) salvar uma versão (auto-save do editor)
curl -X POST 'https://api.pages.asender.net/v1/paginas/<id>/versoes' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{ "template": { "versao": 2, "secoes": [ { "id": "s1", "colunas": [ { "id": "s1c1", "itens": [
        { "id": "t1", "tipo": "titulo", "props": { "texto": "Olá", "nivel": 1 } } ] } ] } ] } }'
# → 201 { "versao": 3 }

# 3) publicar (sem corpo, publica a última salva)
curl -X POST 'https://api.pages.asender.net/v1/paginas/<id>/publicar' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{ "versao": 3 }'
# → 200 { "versao_publicada": 3 }

curl -X POST 'https://api.pages.asender.net/v1/dominios' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{ "host": "lp.empresa.com.br" }'
# → 201 { "id":"…", "host":"lp.empresa.com.br", "registro_txt":"asender-verify=…", "verificado":false }

curl -X POST 'https://api.pages.asender.net/v1/dominios/<id>/verificar' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>'
# → 200 { …, "verificado": true }   (422 se o TXT ainda não propagou; 503 se o DNS não respondeu)

curl -X PUT 'https://api.pages.asender.net/v1/paginas/<id>/dominio' \
  -H 'Authorization: Bearer sk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{ "dominio_id": "dom_01J9XYZ", "caminho": "meu-slug" }'
# → 200 { "pagina_id":"…", "dominio_id":"dom_01J9XYZ", "dominio":"minhaconta.apages.xyz",
#         "caminho":"meu-slug", "url_publica":"https://minhaconta.apages.xyz/meu-slug",
#         "alterado":true, "publicada":true,
#         "redirecionamento": { "criado":true, "de":"https://sites.asender.net/slug-antigo" } }

curl -X POST 'https://api.pages.asender.net/v1/paginas/lote' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{ "acao": "publicar", "ids": ["pag_01","pag_02"], "rascunho": "pular" }'
# → 200 { "lote_id":"lot_…", "acao":"publicar", "total":2, "ok":1, "puladas":1, "erros":0,
#         "resultados":[ {"id":"pag_01","status":"ok","versao":3},
#                        {"id":"pag_02","status":"pulada","motivo":"rascunho_mais_novo"} ] }

curl -X POST 'https://api.pages.asender.net/v1/formularios' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{
    "nome": "Contato",
    "campos": [
      { "nome": "email", "rotulo": "E-mail", "tipo": "email", "obrigatorio": true },
      { "nome": "nome",  "rotulo": "Nome",   "tipo": "texto", "obrigatorio": false }
    ],
    "origens": ["https://empresa.com.br"],
    "mensagem_pos_envio": "Recebemos, obrigado."
  }'
# → 201 { "id": "…", "nome": "Contato", "campos": [ … ] }

{ "versao": 2, "estilo": { "fonte_titulos": "playfair-display", "fonte_texto": "inter" }, "secoes": [ … ] }

curl -X POST 'https://api.pages.asender.net/v1/forms/<form_id>/submissions' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "campos": { "email": "cliente@exemplo.test", "nome": "Fulana" },
    "origem": { "utm_source": "google", "utm_medium": "cpc" }
  }'
# → 201 { "ok": true, "lead_id": "…", "duplicada": false }

curl -X POST 'https://api.asender.net/api/tenants/<tenant_id>/api-keys' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "blog-formularios", "scopes": ["forms:write", "forms:read"] }'
# → o segredo sk_… aparece UMA vez

curl -X PUT 'https://api.pages.asender.net/v1/formularios/externo/blog-contato' \
  -H "Authorization: Bearer $ASENDER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "nome": "Contato do blog",
    "exige_consentimento": true,
    "texto_consentimento": "Concordo em receber comunicações",
    "base_legal": "consentimento",
    "campos": [
      { "nome": "email",    "rotulo": "E-mail",   "tipo": "email",  "obrigatorio": true },
      { "nome": "nome",     "rotulo": "Nome",     "tipo": "texto",  "obrigatorio": true },
      { "nome": "empresa",  "chave": "empresa",    "rotulo": "Empresa", "tipo": "texto" },
      { "nome": "interesse","rotulo": "Interesse", "tipo": "opcao",  "opcoes": ["produto", "parceria"] }
    ]
  }'
# → 201 { "id": "…", "external_id": "blog-contato", "nome": "Contato do blog", "campos": [ … ] }
# → (rodando de novo) 200 { … o mesmo formulário … }

curl -X POST 'https://api.pages.asender.net/v1/forms/externo/blog-contato/submissions' \
  -H "Authorization: Bearer $ASENDER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "campos": { "email": "fulana@exemplo.test", "nome": "Fulana de Tal", "empresa": "Exemplo Ltda", "interesse": "parceria" },
    "id_externo": "blog-sub-48213",
    "consentimento": true,
    "ocorrido_em": "2026-10-08T14:03:00Z",
    "origem": {
      "url": "https://blog.exemplo.test/post/lancamento",
      "utm_source": "newsletter", "utm_medium": "email", "utm_campaign": "lancamento"
    }
  }'
# → 201 { "ok": true, "lead_id": "…", "duplicada": false, "id_externo": "blog-sub-48213" }

{ "erro": "a chave não tem o escopo forms:write" }

{ "error": { "message": "o formulário exige consentimento" } }

npm install @asender/pages-sdk

// app/api/lead/route.ts — RODA NO SERVIDOR
import { createServerClient, AsenderHttpError } from "@asender/pages-sdk";

const pages = createServerClient({ apiKey: process.env.ASENDER_API_KEY! });

export async function POST(req: Request) {
  const { email, nome, empresa } = await req.json();
  try {
    const r = await pages.captureLead({
      formId: "form_da_bioma",
      campos: { email, nome, empresa },           // "empresa" não-mapeado vira custom field
      origem: { utm_source: "bioma", utm_medium: "site" },
    });
    return Response.json({ ok: true, lead_id: r.lead_id, duplicada: r.duplicada });
  } catch (e) {
    if (e instanceof AsenderHttpError) return Response.json({ erro: e.message }, { status: e.status });
    throw e; // rede/validação — não engole
  }
}

import { createBrowserClient } from "@asender/pages-sdk/client";

const pages = createBrowserClient();

form.addEventListener("submit", async (ev) => {
  ev.preventDefault();
  const campos = Object.fromEntries(new FormData(form) as any) as Record<string, string>;
  await pages.submitForm({ formId: "form_da_bioma", campos });
  // /f/{formID} SEMPRE responde 200 (aceito ou spam, indistinguível, por desenho)
});

curl 'https://api.pages.asender.net/v1/analytics/overview?pagina=<id>&de=2026-08-01T00:00:00Z&ate=2026-08-29T00:00:00Z' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>'

curl -X POST 'https://api.pages.asender.net/v1/pixels' \
  -H 'Authorization: Bearer <token-de-sessão>' \
  -H 'X-Asender-Tenant: <slug-da-conta>' \
  -H 'Content-Type: application/json' \
  -d '{ "nome": "Landing principal", "ativo": true }'
# → 201 { "id":"…", "nome":"Landing principal", "ativo":true, "snippet":"<script …></script>" }

304 quando o `If-None-Match` bate; senão o bundle, com cache de uma hora e `X-Content-Type-Options: nosniff`.

Exemplo

curl -X GET 'https://api.pages.asender.net/_f/arquivo_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

resolve a página pela mesma rota que a serviu, monta a submissão com `Modo = pagina` e chama o MESMO pipeline dos outros dois modos.

Exemplo

curl -X POST 'https://api.pages.asender.net/slug_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Resultado do teste A/B por variante

Sem experimento: sessões e conversões por variante na janela (legado). Com experimento (ADR-0093): o relatório estatístico de UM teste — por variante, visitas, conversões, taxa com intervalo de Wilson 95%, chance de ser a melhor (Beta-Binomial), peso configurado e efetivo; o estado (coletando / sem_dados_suficientes / inconclusivo / vencedor_provavel) e a série diária. Conversão = sessão com form_submit; robôs fora.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/ab' \
  -H 'Authorization: Bearer SEU_TOKEN'

Quebra por dimensão

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/breakdown' \
  -H 'Authorization: Bearer SEU_TOKEN'

Eventos brutos

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/events' \
  -H 'Authorization: Bearer SEU_TOKEN'

Mapa de calor

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/heatmap' \
  -H 'Authorization: Bearer SEU_TOKEN'

Instantâneo em tempo real

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/live' \
  -H 'Authorization: Bearer SEU_TOKEN'

Stream em tempo real (SSE)

Server-Sent Events do movimento ao vivo.

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/live/stream' \
  -H 'Authorization: Bearer SEU_TOKEN'

Visão geral do publicado

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/overview' \
  -H 'Authorization: Bearer SEU_TOKEN'

Relatório filtrado (totais, série diária e dimensão)

Atribuição por SESSÃO (primeiro valor preenchido da visita): a conversão que acontece depois da página de entrada herda a origem dela. A comparação com o período anterior é esta mesma rota com a janela anterior.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/relatorio' \
  -H 'Authorization: Bearer SEU_TOKEN'

Eventos de uma sessão

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/session/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Qualidade do tráfego

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/analytics/traffic-quality' \
  -H 'Authorization: Bearer SEU_TOKEN'

Funil e conversão de um formulário

Visualizações e inícios contam SESSÕES únicas; envios vem das submissões gravadas (autoritativo). taxa_conversao = envios / visualizacoes; abandono = (inicios - sessões com envio_ok) / inicios. Série diária no fuso pedido, com zeros nos dias vazios.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios/formID_AQUI/analytics' \
  -H 'Authorization: Bearer SEU_TOKEN'

Listar as visões salvas da conta

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/relatorios/visoes' \
  -H 'Authorization: Bearer SEU_TOKEN'

Salvar o recorte atual como visão

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/relatorios/visoes' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar uma visão

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/relatorios/visoes/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Atualizar uma visão

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/relatorios/visoes/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

304 quando o `If-None-Match` bate; senão o bundle, com cache de uma hora e `X-Content-Type-Options: nosniff`.

Exemplo

curl -X GET 'https://api.pages.asender.net/asender-sw.js' \
  -H 'Authorization: Bearer SEU_TOKEN'

GET /v1/campos-nativos → `{campos, grupos, paises}`.

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/campos-nativos' \
  -H 'Authorization: Bearer SEU_TOKEN'

Enviar uma submissão pelo snippet (anônimo)

Modo embutido em site de terceiro. Sem credencial: a conta sai do próprio formulário, e a origem tem de estar na allowlist DELE (senão 403). Sempre responde 200 — inclusive quando a submissão é classificada como spam (aceitar e descartar são indistinguíveis, por desenho). Um <form> nativo (Accept: text/html) recebe a tela de agradecimento; um XHR recebe o JSON. Servido no runtime, com CORS por formulário. O OPTIONS é o preflight.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/f/formID_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Obter o carimbo de tempo anti-spam do snippet (anônimo)

Chamado pelo script do snippet ao carregar. Devolve um carimbo assinado (HMAC) do instante do pedido, que o snippet reenvia no campo oculto _asender_carimbo do POST /f/{formID}; o runtime mede o tempo de preenchimento com o PRÓPRIO relógio. Mesma allowlist de origem do POST (senão 403, sem CORS) e Cache-Control: no-store. Os campos _asender_website (honeypot), _asender_carimbo e _asender_interacao são reservados: lidos pelo anti-spam e nunca gravados como dado do lead. Sem carimbo, o tempo é tratado como não medido (sem penalidade).

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/f/formID_AQUI/carimbo' \
  -H 'Authorization: Bearer SEU_TOKEN'

Consultar o endereço de um CEP para o widget de endereço (anônimo)

Chamado pelo script do snippet quando o visitante completa o CEP. O runtime confere o formulário (tem endereço? aceita o país? o CEP tem o formato?) e consulta o asender_plataforma_api com a credencial de serviço — o core nunca fica exposto. Mesma política de origem do carimbo; teto de 0.5/s (rajada 10) por formulário × IP e 1/s (rajada 30) por IP. Nenhuma falha trava o formulário: o widget fica manual.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/f/formID_AQUI/endereco' \
  -H 'Authorization: Bearer SEU_TOKEN'

Registrar eventos do funil do formulário embutido (anônimo)

Chamado pelo script do snippet via navigator.sendBeacon (corpo text/plain com JSON, para não disparar preflight). Tipos: impressao, visualizacao, inicio, campo, envio_tentativa, envio_ok, envio_erro. Mesma política de origem do carimbo; limite por formulário × IP. O IP não é gravado (o país vem do GeoIP). Alimenta GET /v1/formularios/{formID}/analytics.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/f/formID_AQUI/eventos' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Enviar uma submissão de um formulário (modo API)

Igual a POST /v1/leads, com o formID (id do Asender) no path. Exige API key com forms:write.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/forms/formID_AQUI/submissions' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Enviar uma submissão pelo id externo do formulário (modo API)

Igual a POST /v1/forms/{formID}/submissions, mas o formulário é achado pelo external_id que você definiu na autoria — você não precisa guardar o id do Asender. Exige API key com forms:write; formulário inexistente (ou de outra conta) responde 404.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/forms/externo/externalID_AQUI/submissions' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Enviar um lead (modo API, com API key)

Modo server-to-server. Exige API key com forms:write; a conta é resolvida da chave e o form_id vem no corpo. Servido no runtime, mas alcançável em https://api.pages.asender.net (e em https://sites.asender.net, igual). Sucesso é 201 (novo) ou 200 (duplicado). Reenviar com o mesmo id_externo é seguro (retry sem duplicar). Limite: 300 requisições por minuto por conta e 64 KB por corpo. Fora de produção use sk_test_… e e-mails @exemplo.test.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/leads' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

304 quando o `If-None-Match` bate; senão o bundle, com cache de uma hora e `X-Content-Type-Options: nosniff`.

Exemplo

curl -X GET 'https://api.pages.asender.net/chat.js' \
  -H 'Authorization: Bearer SEU_TOKEN'

Ingerir um lote de eventos de comportamento (anônimo, credencial de pixel)

Chamado pelo pixel.js no navegador do visitante. A credencial (token assinado do pixel) vai no corpo. Responde 204; 403 para credencial/origem inválida, 429 para excesso. Servido no runtime.

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/collect' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

O script do pixel (anônimo)

Devolve o pixel.js a ser carregado pela página publicada. Servido no runtime, com ETag.

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/pixel.js' \
  -H 'Authorization: Bearer SEU_TOKEN'

Resolver um link curto (anônimo)

Redireciona ao destino do link e conta o clique. Servido no runtime.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/r/slug_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Resolver um link curto (anônimo)

Redireciona ao destino do link e conta o clique. Servido no runtime.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/r/slug_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Resolver um link curto (anônimo)

Redireciona ao destino do link e conta o clique. Servido no runtime.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/r/slug_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Uso e teto de domínios da conta, pelo plano

pages_subdominios = grátis (*.apages.xyz) + subdomínios próprios; pages_dominios_principais = domínios próprios apex. limite: null = ilimitado. O teto vem do plano (plataforma, cache 60 s); sem resposta dela, 503 — nunca "0 de 0". Tenant da sessão, nunca da query.

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/cotas' \
  -H 'Authorization: Bearer SEU_TOKEN'

Listar domínios da conta

Sessão ou API key com pages:read. O domínio padrão da conta (apages.xyz, criado automaticamente) vem primeiro e traz padrao: true; os demais seguem com padrao: false.

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/dominios' \
  -H 'Authorization: Bearer SEU_TOKEN'

Adicionar domínio (gera o TXT de posse)

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/dominios' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Remover domínio

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/dominios/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Estado do DNS automático na Cloudflare

Diz se a zona está na Cloudflare (NS / _domainconnect), se o botão "Conectar com Cloudflare" (Domain Connect) está disponível e se há token guardado. Ritmo: 60/min por conta. Domínio de outra conta = 404.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/dominios/id_AQUI/cloudflare' \
  -H 'Authorization: Bearer SEU_TOKEN'

Aplicar na Cloudflare os registros do Asender

Com o token guardado, cria ou atualiza SÓ os registros do Asender — idempotente, nunca apaga registro alheio, proxied:false em CNAME/A/AAAA. Cada aplicação vai para a trilha de auditoria (também quando falha no meio). Ritmo: 10/min.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/dominios/id_AQUI/cloudflare/aplicar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

URL assinada do Domain Connect (1 clique)

Monta a URL da tela de consentimento da Cloudflare para o template do Asender, só com os grupos que faltam, ASSINADA (RSA-SHA256). retorno é o caminho da tela de domínios (/t/<conta>/dominios); o host de volta vem do servidor. Na volta (?cloudflare=<id>) a tela só chama a verificação. Ritmo: 10/min por conta.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/dominios/id_AQUI/cloudflare/domain-connect' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Remover o token guardado

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/dominios/id_AQUI/cloudflare/token' \
  -H 'Authorization: Bearer SEU_TOKEN'

Guardar o token da Cloudflare (Zone → DNS → Edit)

Valida o token na API da Cloudflare (a zona do domínio tem de estar visível e o DNS legível), cifra (AES-256-GCM) e guarda. O token nunca é devolvido. Ritmo: 10/min.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/dominios/id_AQUI/cloudflare/token' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Remover a página inicial do domínio

Idempotente — domínio já sem home marcada continua respondendo 200.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/dominios/id_AQUI/pagina-inicial' \
  -H 'Authorization: Bearer SEU_TOKEN'

Definir a página inicial (home/apex) do domínio

Marca uma página, já publicada ou não, como a home deste domínio (migration 029) — GET https://host/ passa a resolver nela. A página precisa ser do MESMO tenant e ter dominio igual ao host deste domínio; não publicada é aceita (fica publicada:false na resposta, e / continua 404 até a pessoa publicar).

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/dominios/id_AQUI/pagina-inicial' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Desligar a coleta de Web Push do domínio

Idempotente. Mantém os valores gravados para religar sem nova emissão.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/dominios/id_AQUI/push' \
  -H 'Authorization: Bearer SEU_TOKEN'

Coleta de Web Push nativa do domínio (ADR-0102)

Estado da coleta de inscrições de push neste domínio. Sem configuração responde {"ligado":false}. Domínio de outra conta = 404.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/dominios/id_AQUI/push' \
  -H 'Authorization: Bearer SEU_TOKEN'

Ligar ou configurar a coleta de Web Push do domínio

Grava só valores PÚBLICOS emitidos pela ferramenta Push (GET /v1/push/site-config da asender_push_api): chave VAPID pública, chave de site pk_push_… e a base da API, mais o convite. Com ligado:true, as páginas do domínio servem /asender-sw.js e o convite de inscrição. Exige papel de editor. O domínio precisa estar verificado (409).

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/dominios/id_AQUI/push' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Verificar os 3 passos (TXT, apontamento e certificado)

Confere a posse (TXT, se ainda não provada), o apontamento (CNAME/A para a borda) e, com os dois ok, faz um handshake TLS que aquece o certificado. Responde 200 com o estado de CADA passo (um passo reprovado vem com ok:false e o motivo), e 503 só quando o DNS não respondeu a nada.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/dominios/id_AQUI/verificar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Reservar um subdomínio grátis

Nasce verificado e pronto (posse da plataforma, TLS pelo certificado curinga). Conta no recurso pages_subdominios (que conta SÓ os grátis; host do cliente, como bio.cliente.com.br, conta em pages_dominios_principais). base opcional escolhe a base grátis (vazia = a padrão). Liberar é DELETE /v1/dominios/{id}. Até 10 reservas/trocas por hora por conta (429).

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/subdominios-gratis' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Trocar o nome de um subdomínio grátis (páginas e links vão junto)

O nome antigo fica 30 dias indisponível para outras contas. Grátis de outra conta, ou id que não é grátis, responde 404.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/subdominios-gratis/id_AQUI/trocar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar as bases em que um subdomínio grátis pode ser reservado

As bases grátis da plataforma (apages.xyz e as que forem disponibilizadas). padrao é a primária, usada quando base não é enviada.

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/subdominios-gratis/bases' \
  -H 'Authorization: Bearer SEU_TOKEN'

Conferir se um nome grátis (<rotulo>.<base>) pode ser reservado

Rótulo DNS de 3 a 63 caracteres [a-z0-9-], sem punycode; fora dos nomes reservados da plataforma e das marcas/termos sensíveis (inclusive imitações como 1tau/paypa1). em_uso não diz de qual conta. Teto de 30 consultas por minuto por conta (429).

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/subdominios-gratis/disponivel' \
  -H 'Authorization: Bearer SEU_TOKEN'

devolve o loader com o HTML atual do formulário embutido como string JSON.

Exemplo

curl -X GET 'https://api.pages.asender.net/f/formID_AQUI/embed.js' \
  -H 'Authorization: Bearer SEU_TOKEN'

redireciona (302) para o favicon do site (o de SEO, senão o da marca) quando o dono do host configurou um https; senão para o padrão `/favicon.svg`.

Exemplo

curl -X GET 'https://api.pages.asender.net/favicon.ico' \
  -H 'Authorization: Bearer SEU_TOKEN'

o SVG fixo, cacheável por um dia.

Exemplo

curl -X GET 'https://api.pages.asender.net/favicon.svg' \
  -H 'Authorization: Bearer SEU_TOKEN'

GET /v1/formularios/{formID}/envios?limite=&cursor=&desde=&ate=.

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios/formID_AQUI/envios' \
  -H 'Authorization: Bearer SEU_TOKEN'

GET /v1/formularios/{formID}/envios.csv?desde=&ate=.

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios/formID_AQUI/envios.csv' \
  -H 'Authorization: Bearer SEU_TOKEN'

Listar formulários

Aceita sessão ou API key com forms:read. Com ?external_id= devolve só o formulário com esse id externo (lista vazia se não houver).

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar formulário

Sessão ou API key com forms:write. Envie external_id para amarrar o formulário ao do seu sistema (colisão → 409). Com o header Idempotency-Key, repetir a chamada (mesma chave e mesmo corpo) devolve 201 com o MESMO formulário e Idempotent-Replayed: true; a mesma chave com outro corpo responde 422. Para criar-ou-atualizar sem guardar o id do Asender, prefira PUT /v1/formularios/externo/{external_id}.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/formularios' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar formulário

Sessão ou API key com forms:write. Apagar é lógico: o external_id fica livre para um novo formulário.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/formularios/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter formulário (com o snippet de embed e o rascunho do editor)

Sessão ou API key com forms:read. Formulário de outra conta responde 404.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Atualizar (publicar) formulário

Substitui o recurso inteiro — inclusive o layout — e ZERA o rascunho do editor na mesma escrita. É o "Publicar" do editor. Sessão ou API key com forms:write. external_id ausente mantém o atual; presente e diferente troca, se estiver livre (409 se em uso).

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/formularios/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar destinos do formulário (crm/marketing/webhook)

Os destinos para onde a submissão é copiada, com o mapa de campos de cada um. Anti-IDOR: um formulário de outra conta responde 404.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios/id_AQUI/destinos' \
  -H 'Authorization: Bearer SEU_TOKEN'

Substituir a lista de destinos do formulário

SUBSTITUI a lista inteira (como campos/origens). Valida tipo, mapa e a CONDIÇÃO de cada destino contra os campos atuais (campo inexistente, operador do tipo errado, opção que não existe → 422); Marketing só com "aceite marcado"; webhook exige URL http(s). O SSRF do webhook é conferido no runtime, no instante do despacho. Destino integracao NOVO ou ALTERADO é conferido no serviço de Integrações (instalação existe e é da conta; opções valem) — 422 com codigo (IntegracaoRepetida, LimiteIntegracoes, IntegracaoInvalida, IntegracaoInexistente, OpcaoInvalida) e local; serviço fora → 503 IntegracoesIndisponivel só nesse caso.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/formularios/id_AQUI/destinos' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Descartar o rascunho do editor

Idempotente; o formulário no ar não muda. Formulário de outra conta responde 404.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/formularios/id_AQUI/rascunho' \
  -H 'Authorization: Bearer SEU_TOKEN'

Salvar o rascunho do editor (sem publicar)

Guarda o corpo do PUT do formulário SEM publicá-lo — o formulário no ar não muda. Só a FORMA é conferida (campos desconhecidos → 400, teto de 512 KiB → 413): rascunho pode estar incompleto; as regras rodam no publicar. Anti-IDOR: formulário de outra conta responde 404.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/formularios/id_AQUI/rascunho' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Obter formulário pelo id externo

Sessão ou API key com forms:read. Procura entre os formulários não apagados da conta.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/formularios/externo/external_id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar ou atualizar formulário pelo id externo (upsert idempotente)

Sessão ou API key com forms:write. Se não existe formulário com esse external_id na conta, cria (201); se existe, SUBSTITUI a definição (200), como o PUT /v1/formularios/{id}. Rodar de novo com o mesmo corpo não muda nada. O external_id do path é o que vale.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/formularios/externo/external_id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Gerar um rascunho de página por IA

Produz um rascunho a partir de um pedido em linguagem natural — SEMPRE um documento v2 (sem cabeçalho forçado, sem form_id: o formulário é escolhido no editor). O html que o modelo devolver é REMOVIDO e listado em removidos; item fora do contrato é descartado. NÃO grava nada. Responde 503 quando o provedor de IA não está configurado neste ambiente.

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/ia/gerar-pagina' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar links do encurtador

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/links' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar link (código curto + UTM + parâmetros + repasse)

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/links' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar link (o código nunca é reaproveitado)

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/links/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter link

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/links/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Editar link (código, origem e contagem não mudam)

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/links/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Relatório de cliques do link

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/links/id_AQUI/relatorio' \
  -H 'Authorization: Bearer SEU_TOKEN'

Prévia da URL final (mesma regra do redirect)

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/links/previa' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar links curtos

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/redirects' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar link curto

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/redirects' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar um link curto

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/redirects/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter um link curto

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/redirects/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Atualizar um link curto

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/redirects/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Contagem de cliques do link

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/redirects/id_AQUI/cliques' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter a marca da conta

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/configuracoes/marca' \
  -H 'Authorization: Bearer SEU_TOKEN'

Definir a marca da conta

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/configuracoes/marca' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Kit de marca efetivo de uma página/host

Fallback página → domínio → padrão. Contrato único de consumo do construtor (autopreenchimento) e da geração por IA. Conta sem kit: origem: vazio, kit: null.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/configuracoes/marca/efetivo' \
  -H 'Authorization: Bearer SEU_TOKEN'

Listar os kits de marca da conta

O padrão primeiro; cada kit traz quantos domínios/páginas o usam. Leitura no nível 0 (quem acessa o Pages).

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/configuracoes/marca/kits' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar (ou duplicar) um kit de marca

O primeiro kit da conta nasce padrão. duplicar_de copia os dados de outro kit da conta. Exige papel de editor.

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/configuracoes/marca/kits' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar um kit de marca

Recusado (409) para o kit padrão e para kit em uso por domínio/página — reatribua antes.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/configuracoes/marca/kits/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter um kit de marca

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/configuracoes/marca/kits/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Salvar um kit de marca (nome e dados de uma vez)

PUT: o que não vier é apagado. A resposta traz os valores NORMALIZADOS (URL canônica de rede, E.164, CEP, documento só com dígitos/letras). Se o kit é o padrão, pages.marcas é reprojetada na mesma transação.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/configuracoes/marca/kits/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Tornar um kit o padrão da conta

O padrão vale para todo domínio/página sem kit próprio.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/configuracoes/marca/kits/id_AQUI/padrao' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Onde cada kit vale (domínios e páginas)

Todo domínio vivo da conta com o kit escolhido (kit_id vazio = padrão) e as páginas com kit próprio.

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/configuracoes/marca/vinculos' \
  -H 'Authorization: Bearer SEU_TOKEN'

Escolher o kit de um domínio

kit_id vazio volta ao padrão da conta.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/configuracoes/marca/vinculos/dominios/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Escolher o kit de uma página

kit_id vazio volta ao kit do domínio (ou ao padrão).

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/configuracoes/marca/vinculos/paginas/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar a galeria da conta

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/midias' \
  -H 'Authorization: Bearer SEU_TOKEN'

Enviar uma imagem (multipart)

Envie o arquivo no campo arquivo de um multipart/form-data. O arquivo passa por antivírus antes de ser gravado: infectado = 422; antivírus configurado e fora do ar = 503 com Retry-After (fail-closed — tente de novo).

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/midias' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar uma imagem (soft delete — o arquivo fica; o suporte restaura)

Some da galeria e do endereço público, mas a linha e o ARQUIVO (original e variantes) permanecem no disco; o painel master restaura (ADR-0112). SÓ sessão.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/midias/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Importar uma imagem por URL

Baixa a imagem da URL (com defesa contra SSRF). Desligado quando a importação por URL não está configurada (503).

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/midias/de-url' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Servir uma imagem publicada (anônimo)

Rota PÚBLICA — quem pede é o navegador de um visitante numa página no ar, sem sessão. Devolve os bytes da imagem.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/public/midias/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Servir uma variante redimensionada da imagem (anônimo)

Rota PÚBLICA usada pelo srcset das páginas publicadas. Reduz a imagem para a largura pedida (nunca amplia; proporção e orientação EXIF preservadas) e a entrega em WebP quando o Accept anuncia image/webp (senão JPEG/PNG). A largura é FECHADA numa allowlist — qualquer outro valor é 404, sem tocar no banco nem no disco. Gerada uma vez e guardada; resposta com Cache-Control: public, max-age=31536000, immutable, Vary: Accept, X-Content-Type-Options: nosniff e ETag por (mídia, largura, formato). GIF, SVG, AVIF e imagens acima de 40 megapixels respondem o ORIGINAL (mesmos cabeçalhos da rota do original, inclusive a CSP do SVG).

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/public/midias/id_AQUI/w/largura_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Listar as páginas da conta

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/paginas' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar página

Cria uma página. Um dominio próprio exige posse PROVADA do host (422 se não verificado); um template com conteúdo privilegiado (bloco ou item html, HTML cru) exige nível pelo PEP (403). O template pode ser v1 ou v2 (ver TemplatePagina); recusa de v2 responde 422 com codigo e caminho (ErroConteudo).

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/paginas' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Arquivar a página (soft delete — despublica e esconde; o suporte restaura)

SÓ sessão (chave de API é recusada: chave nunca apaga). Despublica a página e a esconde da lista; as versões e o rascunho ficam guardados e o painel master restaura (volta despublicada). Nada é destruído (ADR-0112). Página inexistente, de outra conta ou já arquivada responde 404 (indistinguível).

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/paginas/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter uma página (com suas versões)

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/paginas/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Editar slug, domínio ou título

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.pages.asender.net/v1/paginas/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Mover a página de domínio e/ou de caminho

Sessão ou API key com pages:write. Troca o endereço público da página: dominio_id é o id do domínio da conta (GET /v1/dominios); "" = host da plataforma. caminho é o slug de um segmento (^[a-z0-9]+(-[a-z0-9]+)*$); "" mantém o slug atual. Se a página já foi publicada alguma vez, o endereço antigo passa a responder 301 (308 em métodos que não GET/HEAD) para o novo. Repetir o mesmo corpo é idempotente (alterado:false). Página ou domínio inexistente, ou de outra conta, responde 404 (indistinguível).

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/paginas/id_AQUI/dominio' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Tentar copiar de novo as mídias que ficaram na URL original

Roda a cópia de mídia sobre a ÚLTIMA versão da página (a mídia que já é da conta vira ja_na_conta, sem duplicar). Se alguma URL mudou, grava uma versão nova (não publica); senão responde 200 sem versão nova.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/paginas/id_AQUI/midias/copiar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Publicar uma versão

Publica a versão indicada; na sessão, sem corpo publica a última salva. API key (pages:publish): o corpo com versao é OBRIGATÓRIO (422 sem ele) — a chave publica uma versão que ela mesma identificou, nunca "a mais recente" às cegas (que poderia ser uma edição de pessoa ainda não revisada). Publicar é visível ao público e indexável.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/paginas/id_AQUI/publicar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Descartar o rascunho pendente

Idempotente; versões e a publicada não mudam. Página de outra conta responde 404.

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/paginas/id_AQUI/rascunho' \
  -H 'Authorization: Bearer SEU_TOKEN'

Ler o rascunho pendente da página

O rascunho é UM por página, guardado SEM criar versão e SEM publicar. rascunho_em é a etiqueta de concorrência otimista; rascunho_por aparece quando foi uma chave de API quem gravou (apikey:<key_id>). Sem rascunho: 204.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/paginas/id_AQUI/rascunho' \
  -H 'Authorization: Bearer SEU_TOKEN'

Gravar o rascunho (sem criar versão e sem publicar)

Guarda o template como ele está, SEM as regras de publicação (só a forma: objeto JSON dentro do teto de 512 KiB) — elas rodam ao salvar versão e ao publicar. ?base=<rascunho_em> é a concorrência otimista: se o rascunho do servidor mudou desde o que você leu, nada é gravado e a resposta é 409 (codigo: RascunhoConflito) trazendo o rascunho do servidor — os dois lados ficam preservados. ?base= vazio significa "esperava não haver rascunho". Na sessão ?base= é opcional (clientes antigos gravam sem condição); na API key é OBRIGATÓRIO (428 sem ele): o agente nunca pisa no trabalho de uma pessoa.

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.pages.asender.net/v1/paginas/id_AQUI/rascunho' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Salvar uma nova versão (auto-save do editor)

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/paginas/id_AQUI/versoes' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Importar um arquivo exportado, copiando a mídia para a conta

Cria uma página (despublicada) a partir do template de um arquivo exportado (asender_pages_template: 2) e COPIA para a biblioteca da conta da sessão toda mídia referenciada (imagem de item, galeria, fundo de seção/coluna/página, ícone enviado, avatar/logo, imagem de compartilhamento): baixa de novo no servidor (mesmas guardas de SSRF da importação por URL, até 3 redirecionamentos, teto por arquivo e por importação, sniff de tipo, SVG sanitizado, antivírus) e troca cada URL pela nova. O que não puder ser copiado MANTÉM a URL original e aparece no relatório como mantido_original com o motivo. Referências presas à conta de origem (form_id que a conta não tem, *_rastreio, vínculos) são removidas, com aviso. A conta vem da sessão; o corpo não aceita tenant_id. Regras de POST /v1/paginas (domínio verificado, item privilegiado) valem aqui.

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/paginas/importar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Ação em massa sobre páginas (publicar, despublicar, duplicar, mudar domínio, arquivar)

Executa UMA ação sobre até 100 páginas, cada uma de forma independente (sem tudo-ou-nada): o corpo da resposta traz o desfecho POR PÁGINA (ok, pulada ou erro, com motivo). A conta vem da sessão/chave; cada id é resolvido dentro dela e um id de outra conta é reportado como nao_encontrada, indistinguível de um id inexistente. simular: true devolve o que aconteceria, sem escrever nada. publicar publica a última versão SALVA e é idempotente (já no ar = ok com sem_mudanca). Conteúdo recusado pelo contrato de domínio é pulada/conteudo_invalido. Se houver rascunho de servidor mais novo que a última versão, a política rascunho decide: pular (padrão — pulada/rascunho_mais_novo) ou publicar_salva (publica a última versão salva; o rascunho NUNCA vira versão nem é descartado). despublicar tira do ar sem tocar em versões nem rascunho (idempotente). duplicar cria uma cópia despublicada da última versão salva (-copia, -copia-2…), com a mesma guarda de bloco privilegiado da criação. mudar_dominio delega ao serviço de mudança de domínio (mesmo contrato de PUT /v1/paginas/{id}/dominio, incluindo o 301 do endereço antigo); dominio_id é obrigatório ("" = host da plataforma) e caminho_por_pagina opcional (ausente = mantém o caminho atual). Cada página processada grava um log de auditoria (lote_id, conta, usuário, ação, desfecho). Limite de ritmo: 12 chamadas por minuto por conta (429). arquivar é o soft delete da página (despublica e esconde; versões e rascunho ficam; o master restaura — ADR-0112). SÓ sessão: chave de API é recusada (403). API key: publicar e despublicar exigem pages:publish; duplicar e mudar_dominio exigem pages:write (sem o escopo da ação, 403).

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/paginas/lote' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

GET /pixel.{versao}.js — o mesmo script de `Script`, com `CacheScriptVersionado` quando a versão pedida é a servida e `CacheScriptVersaoAntiga` quando não é.

Exemplo

curl -X GET 'https://api.pages.asender.net/pixel.versao:[0-9a-f]{16_AQUI}.js' \
  -H 'Authorization: Bearer SEU_TOKEN'

Listar pixels

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/pixels' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar pixel (devolve o snippet com a credencial)

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/pixels' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar um pixel

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/pixels/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Obter um pixel

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/pixels/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Editar um pixel

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.pages.asender.net/v1/pixels/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar conversões do pixel

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.pages.asender.net/v1/pixels/id_AQUI/conversions' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar conversão

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.pages.asender.net/v1/pixels/id_AQUI/conversions' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar conversão

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.pages.asender.net/v1/pixels/id_AQUI/conversions/cid_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Editar conversão

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.pages.asender.net/v1/pixels/id_AQUI/conversions/cid_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'