Pular para o conteúdo principal
Este guia leva você do zero até sua primeira chamada de API autenticada. Você vai precisar de uma conta iZap no ambiente que estiver usando (produção ou staging).

​
Passo 1: obtenha um token de acesso

A API autentica cada requisição com um Bearer JWT. Para começar rápido, troque suas credenciais de conta por um token no endpoint de login: 
curl -X POST "https://api.izap.ai/api/v1/auth/jwt/login" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "username=$IZAP_EMAIL&password=$IZAP_PASSWORD"
# -> {"access_token":"<JWT>","token_type":"bearer"}
Para aplicações de terceiros, use o fluxo OAuth 2.0 authorization-code + PKCE em vez de armazenar credenciais. Veja Autenticação.

​
Passo 2: chame a API

Envie o token como um header Bearer em cada requisição: 
export IZAP_TOKEN="<JWT>"
curl "https://api.izap.ai/api/v1/businesses" \
     -H "Authorization: Bearer $IZAP_TOKEN"
Os tokens expiram — renove-os (fazendo login novamente ou via OAuth refresh grant) quando uma requisição retornar 401.

​
Passo 3: conecte o Analytics MCP (opcional)

Prefere controlar a iZap a partir de um cliente ou agente de IA? Aponte-o para o servidor iZap Analytics MCP e chame as ferramentas diretamente: 
{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}
Veja Analytics MCP para o catálogo completo de ferramentas.
Quer que a configuração seja feita para você? npx @izap/wizard grava um cliente REST, MCP, webhook ou SSE funcional no seu projeto. Veja o assistente de configuração.

​
Próximos passos

Autenticação

Fluxo OAuth 2.0, descoberta e uso de JWT.

API REST

Os recursos que a iZap expõe e como chamá-los.