api.user.get() → User | api.account.me() | Restituisce { user, applications, databases }. |
user.plan.expiresIn | new Date(user.plan.duration) | Un timestamp; null non scade mai. |
api.user.snapshots(scope) | api.account.snapshots({ scope }) | |
api.service.status() | api.service.status() | Nuova struttura: status, message, services, dependencies… |
api.applications.get() | (await api.account.me()).applications | |
api.applications.get(id) / fetch(id) / app.fetch() | api.apps.get(id) | Trova anche le app condivise tramite workspace. |
app.isWebsite() | Boolean((await api.apps.get(id)).domain) | |
api.applications.create(file) | api.apps.create(file, { signal }) | Un percorso, Blob/File o Uint8Array; nessun timeout. |
api.applications.statusAll() | api.apps.statusAll({ workspaceId? }) | Oggetti semplici { id, running, cpu?, ram? } (la v5 annidava cpu/ram sotto usage). |
statusAll()[i].fetch() (SimpleApplicationStatus, SimpleDatabaseStatus) | api.apps.status(id) / api.databases.status(id) | |
api.applications.domains() / loadBalancers() | api.apps.domains() / api.apps.loadBalancers() | |
app.getStatus() | api.apps.status(id, { raw? }) | cpu, ram, storage e network sono al primo livello (la v5 li annidava sotto usage); uptime è il timestamp di avvio in ms (null quando arrestata), non un Date. |
app.getLogs() | api.apps.logs(id) | |
app.getMetrics() | api.apps.metrics(id) | Punto più recente per primo. |
app.realtime() → Response grezzo | api.apps.realtime(id, { signal }) | Un async iterable di eventi già analizzati. |
app.start() / stop() / restart() / delete() | api.apps.start(id) / stop(id) / restart(id) / delete(id) | |
app.commit(file, fileName) | api.apps.commit(id, file, { path?, filename?, signal? }) | |
app.files.list(path) | api.apps.files.list(id, path?) | Una directory mancante lancia 404 FILE_NOT_FOUND (prima era un elenco vuoto). |
app.files.read(path) → Buffer | undefined | api.apps.files.read(id, path) → Uint8Array | Richiesto in base64 e decodificato (la v5 leggeva un array di byte). Byte vuoti, mai undefined, quando l’API non invia contenuto. |
app.files.create(file, fileName, dir) | api.apps.files.write(id, `${dir}/${fileName}`, content) | Una stringa è il contenuto (inviato come testo semplice); la v5 la interpretava come percorso locale. I byte vengono inviati in base64. Un contenuto vuoto crea un file vuoto. |
app.files.edit(file, path) | api.apps.files.write(id, path, content) | Stesso formato di trasmissione di write: testo per le stringhe, base64 per i byte. |
app.files.move(path, newPath) / delete(path) | api.apps.files.move(id, path, to) / delete(id, path) | |
app.envs.list() | api.apps.envs.get(id) | |
app.envs.set(envs) / replace(envs) / delete(keys) | api.apps.envs.set(id, envs) / replace(id, envs) / delete(id, keys) | Ognuno restituisce le variabili risultanti. |
app.snapshots.list() | api.apps.snapshots.list(id) | Gli elementi acquisiscono name, runtime, origin, version_id e un url di download firmato, tutti come li invia l’API. |
app.snapshots.create() | api.apps.snapshots.create(id) | { pending: true } in caso di 202 (la v5 lanciava un errore), altrimenti { pending: false, url, key }. |
app.snapshots.download() → Buffer | const s = await api.apps.snapshots.create(id), poi if (!s.pending) await api.downloadSnapshot(s.url) | Un ReadableStream, nulla bufferizzato. Uno snapshot in sospeso (202) non ha ancora un URL: la v5 lanciava un errore. |
snapshot.url / snapshot.download() | snapshot.url / api.downloadSnapshot(snapshot.url) | L’URL firmato dell’API (la v5 ne costruiva uno sbagliato a partire dall’id del chiamante). |
app.snapshots.restore({ snapshotId, versionId }) | api.apps.snapshots.restore(id, name, versionId) | Passa name e version_id di uno snapshot presente nell’elenco. Vedi Snapshot per gli errori. |
app.deploys.integrateGithubWebhook(token) | api.apps.deploys.setWebhook(id, token) | Restituisce l’URL del webhook ("" quando viene rimosso con "@"). |
app.deploys.linkGithubApp({ repositoryName, repositoryBranch }) | api.apps.deploys.linkGithubApp(id, repository, branch) | Posizionale. Restituisce { id, full_name, branch }. Ora sono accettate le chiavi API (scope apps:deploy); la v5 richiedeva un JWT di sessione. |
app.deploys.unlinkGithubApp() → boolean | api.apps.deploys.unlinkGithubApp(id) | Si risolve in void (prima boolean). 400 GIT_NOT_CONFIGURED quando non c’è nulla di collegato. |
app.deploys.list() → Deployment[][] | api.apps.deploys.list(id) → DeployEvent[][] | Un deploy fallito termina con state: "error" e code (e message quando ci sono dettagli); source è sempre "git". |
app.deploys.current() | api.apps.deploys.current(id) → DeployCurrent | {} quando non c’è nulla di configurato. |
app.deploys.webhookURL() | (await api.apps.deploys.current(id)).webhook | |
app.network (solo su WebsiteApplication) | api.apps.network | Qualsiasi id di app; l’API rifiuta le app non web. |
network.setCustomDomain(domain) | api.apps.network.setDomain(id, domain) | |
network.analytics({ start, end, contentType, ... }) | api.apps.network.analytics(id, start, end, { content_type, ... }) | null per una finestra vuota. |
network.errors({ start, end, include4xx }) | api.apps.network.errors(id, start, end, { include_4xx }) | null per una finestra vuota. |
network.logs({ start, end }) / performance({ start, end }) | api.apps.network.logs(id, start, end) / performance(id, start, end) | |
network.dns() / purgeCache() | api.apps.network.dns(id) / purgeCache(id) | |
api.databases.fetch(id) / db.fetch() | api.databases.get(id) | |
api.databases.create(options) / statusAll() | invariato | statusAll() restituisce oggetti semplici { id, running, cpu?, ram? }. |
db.getStatus() / getMetrics() | api.databases.status(id, { raw? }) / metrics(id) | ram è la RAM in uso, ad es. "120.4MB" (un numero con raw). Le metriche arrivano dalla più recente. |
db.start() / stop() / update(changes) / delete() | api.databases.start(id) / stop(id) / update(id, changes) / delete(id) | |
db.credentials.certificate() | api.databases.certificate(id) | |
db.credentials.reset(type) | api.databases.resetCredentials(id, type) | La nuova password ("" per "certificate"). |
db.snapshots.list() / create() / download() | api.databases.snapshots.list(id) / create(id) / api.downloadSnapshot(url) | download() come per le app: create(id), poi downloadSnapshot(s.url) quando non è in sospeso. |
db.snapshots.restore(snapshotId, versionId) | api.databases.snapshots.restore(id, name, versionId) | Passa name e version_id di uno snapshot presente nell’elenco. |
api.workspaces.list() / fetch(id) / workspace.fetch() | api.workspaces.list() / get(id) | |
api.workspaces.create({ name }) | api.workspaces.create(name) | Restituisce WorkspaceCreated ({ id, name }). |
api.workspaces.delete(id) / workspace.delete() | api.workspaces.delete(id) | |
api.workspaces.leave(id) / workspace.leave() | api.workspaces.leave(id) | |
api.workspaces.generateInviteCode() | api.workspaces.members.inviteCode() | |
workspace.members.add(code, group) | api.workspaces.members.add(workspaceId, code, group) | |
workspace.members.update(memberId, group) / remove(memberId) | api.workspaces.members.update(workspaceId, memberId, group) / remove(workspaceId, memberId) | |
workspace.applications.add(appId) / remove(appId) | api.workspaces.apps.add(workspaceId, appId) / remove(workspaceId, appId) | |
| (nessuno) | api.ai.chat(request), api.downloadSnapshot(url), BASE_URL | Nuovo. |