API aberta, webhook e MCP

Crie uma chave em Minha conta. Todas as chamadas usam Authorization: Bearer ik_... (ou ?api_key=ik_...).

1. API aberta (leitura)

GET https://askaner.askan.com.br/api/v1/connectors
GET https://askaner.askan.com.br/api/v1/connectors/{slug}/fields?kind=metric&q=spend
GET https://askaner.askan.com.br/api/v1/data/{slug}?fields=date,campaign,spend&date_preset=last_7d
GET https://askaner.askan.com.br/api/v1/data/all?fields=date,source,account_id&select_accounts=facebook__123

Parâmetro	Significado
`fields`	Campos separados por vírgula. Sem ele, devolve todos.
`date_preset`	today, yesterday, last_7d, last_14d, last_30d, last_90d, this_month, last_month, last_year
`date_from`, `date_to`	Intervalo AAAA-MM-DD (tem prioridade sobre o preset)
`select_accounts`	Contas separadas por vírgula; em `all` use `conector__conta`
`filter`	JSON: `[["campaign","eq","Black"],"and",["spend","gt",100]]`. Operadores: eq, neq, contains, notcontains, gt, gte, lt, lte
`limit`	Máximo de linhas (padrão e teto: 10000)

Resposta: { "data": [ {...} ] }.

2. Webhook de entrada (genérico)

Crie um endpoint em Minha conta e envie dados de qualquer sistema:

curl -X POST https://askaner.askan.com.br/api/v1/webhooks/SEU_TOKEN \
  -H "Content-Type: application/json" \
  -d '[{"date":"2026-10-30","account_id":"loja-1","campaign":"Black","spend":120.5,"clicks":340}]'

Aceita um objeto, uma lista ou {"data":[...]}. Números viram métricas e o resto vira dimensões. Depois os dados saem pela API e pelo MCP. Máximo de 5000 linhas por chamada e 1 MB.

3. MCP

Servidor remoto (somente leitura). Em clientes que aceitam cabeçalhos:

{
  "mcpServers": {
    "askaner": {
      "url": "https://askaner.askan.com.br/api/mcp",
      "headers": { "Authorization": "Bearer ik_..." }
    }
  }
}

Ferramentas: list_connectors, get_connector_fields, query_data.