Skip to main content

API Pública IndiqAI

A API Pública IndiqAI permite que sistemas externos — como ERPs, PDVs, CRMs e automações — integrem diretamente com a plataforma de fidelização e indicações da sua empresa.

Para quem é

  • ERPs que precisam registrar vendas e creditar pontos automaticamente
  • PDVs que carimbam cartões fidelidade no momento da compra
  • CRMs que sincronizam cadastro de clientes
  • Automações que geram cupons, consultam métricas ou gerenciam produtos programaticamente

Requisitos

A API Pública requer um plano com a feature api_access habilitada. Verifique seu plano no Dashboard em Configurações > Plano.
  1. Plano compatível: seu plano deve incluir api_access
  2. API Key ativa: gere sua chave no Dashboard > Integrações > Chaves de API
  3. HTTPS obrigatório: todas as requisições devem usar https://

Como obter sua API Key

  1. Acesse o Dashboard da sua empresa
  2. Navegue até Integrações > Chaves de API
  3. Clique em Criar nova chave
  4. Dê um nome descritivo (ex: “ERP Produção”, “PDV Loja Centro”)
  5. Copie a chave gerada — ela será exibida apenas uma vez
A chave tem o formato indiqai_xxxx... e deve ser enviada no header X-API-Key de todas as requisições.

Base URL

Selecione o ambiente no seletor de servidor do playground:
AmbienteURL
Produçãohttps://api.indiqai.com/api/v1/public
Develophttps://apidev.indiqai.com/api/v1/public

Recursos disponíveis

RecursoDescrição
ClientesCadastro e consulta de clientes
CuponsGeração, consulta e uso de cupons
ProdutosCatálogo de produtos
Cartões FidelidadeCartões e carimbos
PontosSaldo e crédito de pontos
MétricasKPIs resumidos da operação
PrêmiosRecompensas disponíveis

Limites

  • Rate limit: 60 requisições por minuto por API Key
  • Scopes v1: acesso completo aos recursos da empresa (["*"])
  • Scopes granulares planejados para v2

Próximos passos

Autenticação

Configure sua API Key

Rate Limits

Entenda os limites de uso

Erros

Tratamento de erros padrão

Clientes

Comece listando clientes