ISN CloudDocs
llms.txtCriar chave
API v1

Documentação da API

Controle suas aplicações pelos seus bots, scripts ou painéis. Todas as respostas são JSON. Para assistentes de IA, use o llms.txt.

https://insanecloud.lovable.app/api/public/v1

Autenticação

Crie uma chave no painel em Chaves de API. Ela aparece uma única vez. Envie no cabeçalho:

Authorization: Bearer isn_••••••••
GET/apps

Listar aplicações

Retorna todas as aplicações da conta dona da chave.

cURL
curl -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/apps
Resposta
{ "apps": [{ "id": "uuid", "name": "meu-bot", "runtime": "python", "ram_mb": 256, "status": "running" }] }
GET/apps/{id}/status

Status em tempo real

CPU, RAM, uptime e se a aplicação está rodando.

cURL
curl -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/apps/APP_ID/status
Resposta
{ "running": true, "cpu": "0.5%", "ram": "45MB", "uptime": 1731430000000 }
GET/apps/{id}/logs

Logs

Últimas linhas do console da aplicação.

cURL
curl -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/apps/APP_ID/logs
Resposta
{ "logs": "[INFO] Bot online..." }
POST/apps/{id}/start

Iniciar

Liga a aplicação. Exige plano ativo.

cURL
curl -X POST -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/apps/APP_ID/start
Resposta
{ "ok": true }
POST/apps/{id}/restart

Reiniciar

Reinicia a aplicação. Exige plano ativo.

cURL
curl -X POST -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/apps/APP_ID/restart
Resposta
{ "ok": true }
POST/apps/{id}/stop

Parar

Desliga a aplicação.

cURL
curl -X POST -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/apps/APP_ID/stop
Resposta
{ "ok": true }
GET/admin/billing?days=30

Faturamento (admin)

Somente chaves de administradores. MRR, receita, assinantes, apps, receita diária e últimos pagamentos.

cURL
curl -H "Authorization: Bearer $ISN_KEY" https://insanecloud.lovable.app/api/public/v1/admin/billing?days=30
Resposta
{ "mrrCents": 15800, "revenuePeriodCents": 23700, "activeSubscribers": 12, "daily": [...], "payments": [...] }

Erros

401Chave ausente ou inválida
402Plano inativo ou vencido
403Sem permissão (ex.: chave não-admin)
404Aplicação ou ação não encontrada
405Método HTTP errado
409Aplicação sem código enviado