api.user.get() → User | api.account.me() | Devuelve { user, applications, databases }. |
user.plan.expiresIn | new Date(user.plan.duration) | Una marca de tiempo; null nunca caduca. |
api.user.snapshots(scope) | api.account.snapshots({ scope }) | |
api.service.status() | api.service.status() | Nueva forma: status, message, services, dependencies… |
api.applications.get() | (await api.account.me()).applications | |
api.applications.get(id) / fetch(id) / app.fetch() | api.apps.get(id) | También encuentra aplicaciones compartidas en workspaces. |
app.isWebsite() | Boolean((await api.apps.get(id)).domain) | |
api.applications.create(file) | api.apps.create(file, { signal }) | Una ruta, Blob/File o Uint8Array; sin timeout. |
api.applications.statusAll() | api.apps.statusAll({ workspaceId? }) | Objetos planos { id, running, cpu?, ram? } (la v5 anidaba cpu/ram dentro de 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 y network están en el nivel superior (la v5 los anidaba dentro de usage); uptime es la marca de tiempo de inicio en ms (null cuando está detenida), no un Date. |
app.getLogs() | api.apps.logs(id) | |
app.getMetrics() | api.apps.metrics(id) | El punto más reciente primero. |
app.realtime() → Response sin procesar | api.apps.realtime(id, { signal }) | Un async iterable de eventos ya analizados. |
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?) | Un directorio inexistente lanza 404 FILE_NOT_FOUND (antes era una lista vacía). |
app.files.read(path) → Buffer | undefined | api.apps.files.read(id, path) → Uint8Array | Se solicita en base64 y se decodifica (la v5 leía un array de bytes). Bytes vacíos, nunca undefined, cuando la API no envía contenido. |
app.files.create(file, fileName, dir) | api.apps.files.write(id, `${dir}/${fileName}`, content) | Un string es el contenido (se envía como texto plano); la v5 lo interpretaba como una ruta local. Los bytes se envían en base64. Un contenido vacío crea un archivo vacío. |
app.files.edit(file, path) | api.apps.files.write(id, path, content) | El mismo formato de envío que write: texto para strings, base64 para bytes. |
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) | Cada uno devuelve las variables resultantes. |
app.snapshots.list() | api.apps.snapshots.list(id) | Los elementos ganan name, runtime, origin, version_id y una url de descarga firmada, todo tal como lo envía la API. |
app.snapshots.create() | api.apps.snapshots.create(id) | { pending: true } en un 202 (la v5 lanzaba un error); si no, { pending: false, url, key }. |
app.snapshots.download() → Buffer | const s = await api.apps.snapshots.create(id), y después if (!s.pending) await api.downloadSnapshot(s.url) | Un ReadableStream, sin nada en memoria. Un snapshot pendiente (202) aún no tiene URL: la v5 lanzaba un error. |
snapshot.url / snapshot.download() | snapshot.url / api.downloadSnapshot(snapshot.url) | La URL firmada de la propia API (la v5 construía una incorrecta a partir del id del llamante). |
app.snapshots.restore({ snapshotId, versionId }) | api.apps.snapshots.restore(id, name, versionId) | Pasa el name y el version_id de un snapshot del listado. Consulta Snapshots para ver los errores. |
app.deploys.integrateGithubWebhook(token) | api.apps.deploys.setWebhook(id, token) | Devuelve la URL del webhook ("" cuando se elimina con "@"). |
app.deploys.linkGithubApp({ repositoryName, repositoryBranch }) | api.apps.deploys.linkGithubApp(id, repository, branch) | Posicional. Devuelve { id, full_name, branch }. Ahora se aceptan claves de API (scope apps:deploy); la v5 necesitaba un JWT de sesión. |
app.deploys.unlinkGithubApp() → boolean | api.apps.deploys.unlinkGithubApp(id) | Se resuelve en void (antes boolean). 400 GIT_NOT_CONFIGURED cuando no hay nada vinculado. |
app.deploys.list() → Deployment[][] | api.apps.deploys.list(id) → DeployEvent[][] | Un deploy fallido termina en state: "error" con code (y message cuando hay detalles); source es siempre "git". |
app.deploys.current() | api.apps.deploys.current(id) → DeployCurrent | {} cuando no hay nada configurado. |
app.deploys.webhookURL() | (await api.apps.deploys.current(id)).webhook | |
app.network (solo en WebsiteApplication) | api.apps.network | Cualquier id de aplicación; la API rechaza las aplicaciones que no son 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 para una ventana vacía. |
network.errors({ start, end, include4xx }) | api.apps.network.errors(id, start, end, { include_4xx }) | null para una ventana vacía. |
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() | sin cambios | statusAll() devuelve objetos planos { id, running, cpu?, ram? }. |
db.getStatus() / getMetrics() | api.databases.status(id, { raw? }) / metrics(id) | ram es la RAM en uso, p. ej. "120.4MB" (un número con raw). Las métricas llegan del punto más reciente al más antiguo. |
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 nueva contraseña ("" para "certificate"). |
db.snapshots.list() / create() / download() | api.databases.snapshots.list(id) / create(id) / api.downloadSnapshot(url) | download() igual que en las aplicaciones: create(id) y después downloadSnapshot(s.url) cuando no está pendiente. |
db.snapshots.restore(snapshotId, versionId) | api.databases.snapshots.restore(id, name, versionId) | Pasa el name y el version_id de un snapshot del listado. |
api.workspaces.list() / fetch(id) / workspace.fetch() | api.workspaces.list() / get(id) | |
api.workspaces.create({ name }) | api.workspaces.create(name) | Devuelve 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) | |
| (ninguno) | api.ai.chat(request), api.downloadSnapshot(url), BASE_URL | Nuevo. |
