> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Logs do projeto
> Receba os logs do projeto ao vivo, por Server-Sent Events.
Os logs chegam por **Server-Sent Events**: uma conexão HTTP que fica aberta e recebe eventos de texto. Primeiro vêm as últimas linhas, depois as novas, ao vivo.
## Eventos
Uma linha do log.
Quando a linha foi escrita (ISO 8601, UTC).
De onde veio a linha. `build` só com `source=build`.
O texto da linha, até 4.096 caracteres.
O projeto mudou de estado.
O [status](/api-reference/introduction#o-ciclo-de-vida-de-um-projeto) novo.
Quedas seguidas até agora.
O motivo, `{ code, message }`, quando o status novo é `error` ou `crash_loop`. Veja [Estados de erro do projeto](/errors#estados-de-erro-do-projeto).
Linhas que começam com `:` são comentários (`: open` na abertura e `: ping` a cada 20 segundos): ignore.
O log é texto do seu app. Mostre sempre como texto, nunca como HTML. `stdout` e `stderr` podem chegar fora de ordem entre si: ordene por `time` se precisar.
## Limites
* Uma abertura a cada 5 segundos por projeto e origem (`app` ou `build`).
* Até 5 streams abertos ao mesmo tempo por conta.
* Se a chave for revogada, o stream fecha em até 20 segundos.
Se a conexão cair, espere o `Retry-After` (quando houver) e abra de novo. As últimas linhas vêm de novo na reabertura, então limpe a tela ou descarte as repetidas.
```text 200 theme={"dark"}
: open
event: line
data: {"time":"2026-09-26T18:01:09.870Z","stream":"stdout","text":"Iniciando o bot..."}
event: line
data: {"time":"2026-09-26T18:01:10.123Z","stream":"stdout","text":"Logado como MeuBot#1234"}
event: status
data: {"status":"restarting","consecutiveCrashes":1,"error":null}
: ping
```
## OpenAPI
````yaml GET /projects/{id}/logs
openapi: 3.1.0
info:
title: API da Cube Hosting
version: 1.0.0
description: >-
Hospede bots de Discord, sites e APIs em Node.js e Python: envie o .zip,
inicie, pare, reinicie, leia logs e métricas e cuide das variáveis de
ambiente.
contact:
name: Cube Hosting
url: https://discord.gg/pv6D9tUsDV
servers:
- url: https://app.cubehosting.com.br/api
security:
- bearerAuth: []
tags:
- name: Projetos
- name: Controle
- name: Logs e métricas
- name: Variáveis de ambiente
paths:
/projects/{id}/logs:
get:
tags:
- Logs e métricas
summary: Logs do projeto (ao vivo)
description: >-
Abre um stream de [Server-Sent
Events](https://developer.mozilla.org/pt-BR/docs/Web/API/Server-sent_events):
primeiro chegam as últimas `lines` linhas, depois as novas, ao vivo. O
stream fica aberto até você fechar.
- `event: line` traz uma linha do log: `time`, `stream` (`stdout`,
`stderr` ou `build`) e `text` (até 4.096 caracteres).
- `event: status` chega a cada mudança de estado do projeto, com
`status`, `consecutiveCrashes` e `error` (o motivo, em `error` e
`crash_loop`).
- Um comentário `: ping` chega a cada 20 segundos para manter a conexão.
O log é texto do seu app: mostre como texto, nunca como HTML. `stdout` e
`stderr` podem chegar fora de ordem entre si; ordene por `time`. Uma
abertura a cada 5 segundos por projeto e origem, e até 5 streams abertos
por conta.
operationId: streamProjectLogs
parameters:
- $ref: '#/components/parameters/ProjectId'
- name: lines
in: query
description: Quantas linhas antigas mandar antes das novas.
schema:
type: integer
minimum: 0
maximum: 1000
default: 200
- name: source
in: query
description: >-
`app`: a saída do seu app. `build`: a saída da última instalação e
build.
schema:
type: string
enum:
- app
- build
default: app
responses:
'200':
description: O stream de eventos.
content:
text/event-stream:
schema:
type: string
example: >
: open
event: line
data:
{"time":"2026-09-26T18:01:09.870Z","stream":"stdout","text":"Iniciando
o bot..."}
event: line
data:
{"time":"2026-09-26T18:01:10.123Z","stream":"stdout","text":"Logado
como MeuBot#1234"}
event: status
data:
{"status":"restarting","consecutiveCrashes":1,"error":null}
: ping
'400':
description: Parâmetro fora do formato.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
invalid_request:
summary: invalid_request
value:
status: error
code: invalid_request
message: Use lines de 0 a 1000 e source app ou build.
'401':
description: Chave ausente, inválida ou revogada.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
invalid_api_key:
summary: invalid_api_key
value:
status: error
code: invalid_api_key
message: >-
Chave de API inválida ou revogada. Confira o cabeçalho
"Authorization: Bearer " ou crie outra em Chaves de
API no painel.
'404':
description: O projeto não existe ou não é da sua conta.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
not_found:
summary: not_found
value:
status: error
code: not_found
message: Projeto não encontrado.
'429':
description: Limite de pedidos. Traz o cabeçalho `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
rate_limit_exceeded:
summary: rate_limit_exceeded
value:
status: error
code: rate_limit_exceeded
message: >-
A sua conta passou do limite da API do plano Free: 10
pedidos por minuto. Espere 42 s e tente de novo.
too_many_requests:
summary: too_many_requests
value:
status: error
code: too_many_requests
message: >-
Muitas requisições seguidas. Espere alguns segundos e
tente de novo.
too_many_attempts:
summary: too_many_attempts
value:
status: error
code: too_many_attempts
message: Muitas tentativas. Tente de novo em 15 minutos.
'503':
description: O servidor dos projetos não respondeu a tempo. Nada foi alterado.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
server_unavailable:
summary: server_unavailable
value:
status: error
code: server_unavailable
message: >-
O servidor dos projetos não respondeu. Tente de novo em
instantes.
x-codeSamples:
- lang: bash
label: curl
source: >-
curl -N
"https://app.cubehosting.com.br/api/projects/$PROJECT_ID/logs?lines=100"
\
-H "Authorization: Bearer $CUBE_API_KEY"
- lang: javascript
label: Node.js
source: >-
const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer
${process.env.CUBE_API_KEY}` };
const res = await
fetch(`${API}/projects/${process.env.PROJECT_ID}/logs?lines=100`, {
headers });
const decoder = new TextDecoder();
let rest = '';
for await (const chunk of res.body) {
const events = (rest + decoder.decode(chunk, { stream: true })).split('\n\n');
rest = events.pop();
for (const event of events) {
const data = event.split('\n').find((l) => l.startsWith('data: '));
if (event.startsWith('event: line') && data) console.log(JSON.parse(data.slice(6)).text);
}
}
- lang: python
label: Python
source: |-
import json
import os
import requests
API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}
with requests.get(
f"{API}/projects/{os.environ['PROJECT_ID']}/logs",
params={"lines": 100},
headers=headers,
stream=True,
timeout=120,
) as r:
event = None
for line in r.iter_lines(decode_unicode=True):
if line.startswith("event: "):
event = line[7:]
elif line.startswith("data: ") and event == "line":
print(json.loads(line[6:])["text"])
components:
parameters:
ProjectId:
name: id
in: path
required: true
description: >-
O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto,
e em `GET /projects`.
schema:
type: string
pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
example: 01J8Z3W6N0Q4Y7V2K5T9D1H3XA
schemas:
Error:
type: object
required:
- status
- code
- message
properties:
status:
type: string
const: error
code:
type: string
description: Código fixo em inglês. Veja [Códigos de erro](/errors).
message:
type: string
description: Texto em português para mostrar a uma pessoa.
additionalProperties: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Chave de API da Cube (`cube_…`), criada no painel em **Chaves de API**.
Mande como `Authorization: Bearer cube_…`.
````