Camella · API de desenvolvedor
API de desenvolvedor v1
REST autenticado em /api/v1 para busca agentic, lookup de entidades e histórico financeiro. Cada endpoint exige chave Bearer (auth: true). Os exemplos abaixo usam placeholders — cadastre-se para criar chaves e usar a consola interativa.
Autenticação obrigatória
auth: true
Chave API Bearer
Todos os exemplos usam o placeholder cam_live_YOUR_KEY. Crie uma chave real na consola após upgrade para Enterprise.
Endpoints v1
GET
/api/v1/searchauth: true
Búsqueda agentic multi-paíscurl -sS -H 'Authorization: Bearer cam_live_YOUR_KEY' \
'https://www.camella.app/api/v1/search?q=Pichincha&country=EC&limit=8'GET
/api/v1/entities/{country}/{identifier}auth: true
Lookup de una entidad legalcurl -sS -H 'Authorization: Bearer cam_live_YOUR_KEY' \
'https://www.camella.app/api/v1/entities/ec/1790012345001'GET
/api/v1/entities/{country}/{identifier}/financialsauth: true
Historial financiero (requiere Pro+)Requiere API key de Enterprise
curl -sS -H 'Authorization: Bearer cam_live_YOUR_KEY' \
'https://www.camella.app/api/v1/entities/ec/1790012345001/financials'Limites de taxa (só Enterprise)
Só Enterprise com assinatura ativa pode chamar /api/v1. FREE, Pro e Pro+ recebem 403.
| Plano | / month | / min |
|---|---|---|
| FREE / PRO / PRO+ | — | 403 |
| ENTERPRISE | ∞ | 300 |
Erros
- 401Chave ausente, inválida ou revogada
- 403Não Enterprise, assinatura inativa ou redação de campos
- 429Limite por minuto ou cota mensal
- 404Entidade não encontrada
Em breve v1.1
@camella/sdk, camella CLI, and @camella/mcp — thin clients over this same API.