API Asender

Cada ferramenta é um sistema à parte, com a API dela num endereço próprio. 262 operações abertas em 5 APIs.

Por que endereços separados. Uma API global faz de qualquer pane um evento sistêmico. Aqui o CRM fora do ar é o CRM fora do ar: quem integra com páginas não percebe, e quem usa uma ferramenta não é afetado pela outra. As ferramentas compartilham identidade e se integram entre si — mas falham separadamente.

É um agente que está lendo? Pegue tudo de uma vez em llms-full.txt — guias, todas as operações e todos os schemas em um arquivo de texto. O índice curto está em llms.txt, e a especificação em openapi.json.

Primeira chamada, passo a passo

1. Obtenha um token

A API usa OAuth 2.1 com PKCE. O fluxo começa no Authorization Server e termina com um access_token que você envia em toda requisição.

curl -X POST 'https://auth.asender.net/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=authorization_code' \
  -d 'code=CODIGO_RECEBIDO' \
  -d 'code_verifier=SEU_VERIFIER' \
  -d 'client_id=SEU_CLIENT_ID' \
  -d 'redirect_uri=https://seu-app/callback'

Os endpoints, e os parâmetros que cada um exige, estão publicados pelo próprio servidor em /.well-known/openid-configuration. O guia de convenções explica o fluxo inteiro.

2. Chame a API

curl 'https://api.asender.net/api/contacts?limit=20' \
  -H 'Authorization: Bearer SEU_TOKEN'

3. Leia a resposta

Coleções vêm paginadas por cursor: a resposta traz NextCursor e HasMore. Passe o cursor de volta para pegar a página seguinte — nunca um offset, que pula ou repete item quando o dado muda entre as chamadas.

4. Escreva com segurança

Toda escrita aceita Idempotency-Key. Repetir a mesma chave devolve o MESMO resultado em vez de criar de novo — é o que torna seguro repetir uma requisição cuja resposta você não recebeu.

curl -X POST 'https://api.asender.net/api/messages/send' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f7c1e2a-...' \
  -d '{ }'

Por onde seguir

Convenções da API

Autenticação, formato de requisição e resposta, erros, paginação, idempotência, webhooks e limites.

Referência completa

As 262 operações, com parâmetros, respostas e exemplo de chamada.

As APIs

ferramenta	endereço	operações
Plataforma	`https://api.asender.net`	89
Identidade (OIDC / OAuth 2.1)	`https://auth.asender.net`	42
CRM	`https://api.crm.asender.net`	42
Páginas	`https://api.pages.asender.net`	49
Publicação e analytics	`https://api.sites.asender.net`	40

O token vem sempre da mesma identidade — é o que faz as integrações nativas entre as ferramentas funcionarem sem o integrador remontar credencial a cada uma.