API Reference

Documentação da API

Referência completa de todos os endpoints disponíveis na API da Integra

Autenticação

Como autenticar suas requisições

Todas as requisições à API devem incluir sua chave de API no header Authorization.

Authorization: Bearer YOUR_API_KEY

# Exemplo usando cURL
curl https://api.integra.ai/v1/convai/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints Disponíveis

Explore todos os recursos da nossa API REST

Agents

POST/v1/convai/agents/create

Criar um novo agente conversacional

GET/v1/convai/agents/{agent_id}

Buscar detalhes de um agente específico

PATCH/v1/convai/agents/{agent_id}

Atualizar configurações de um agente

DELETE/v1/convai/agents/{agent_id}

Deletar um agente

Conversations

GET/v1/convai/conversations

Listar todas as conversas

GET/v1/convai/conversations/{id}

Buscar detalhes de uma conversa específica

Knowledge Base

POST/v1/convai/knowledge-base/upload

Upload de documento para base de conhecimento

GET/v1/convai/knowledge-base

Listar documentos da base de conhecimento

Rate Limits

Limites de requisições por minuto

1,000

req/min - Free Tier

5,000

req/min - Pro Tier

Ilimitado

Enterprise Tier

Segurança

Mantenha suas credenciais protegidas

Nunca exponha sua API key em código client-side ou repositórios públicos
Use variáveis de ambiente para armazenar suas credenciais
Regenere suas chaves imediatamente se suspeitar de comprometimento
Todas as requisições devem ser feitas via HTTPS