API REST

La API de Olimpia en api.olimpia.dev, con autenticación por token, para automatizar proyectos, apps, deploys y bases.

La consola de Olimpia usa la misma API que podés usar vos. Base URL:

https://api.olimpia.dev

Autenticación

Mandá un token personal en cada pedido:

curl -H "Authorization: Bearer $OLIMPIA_TOKEN" https://api.olimpia.dev/projects

Los cuerpos van en JSON (content-type: application/json). Los errores responden con un código HTTP y un cuerpo como {"error": "invalid_name"}.

Proyectos

Método	Ruta	Qué hace
`GET`	`/projects`	Lista tus proyectos.
`POST`	`/projects`	Crea un proyecto: `{"name": "staging"}`.
`POST`	`/projects/{id}/move`	Mueve un recurso a este proyecto: `{"kind": "apps", "id": "..."}` (`apps`, `postgres`, `redis` o `buckets`).

Apps

Método	Ruta	Qué hace
`GET`	`/apps?project={id}`	Lista las apps de un proyecto.
`POST`	`/apps`	Crea una app. Ver abajo.
`GET`	`/apps/{id}`	Detalle de la app.
`PATCH`	`/apps/{id}`	Cambia `slug`, `branch`, `root_dir`, `dockerfile`, `image`, `port` o `auto_deploy`.
`DELETE`	`/apps/{id}`	Borra la app.
`GET`	`/apps/{id}/env`	Lee las variables.
`PUT`	`/apps/{id}/env`	Reemplaza todas las variables: `{"vars": [{"key": "K", "value": "V"}]}`.
`POST`	`/apps/{id}/source`	Devuelve `{key, upload_url}` para subir código.
`GET`	`/apps/{id}/deployments`	Últimos 50 deploys, del más nuevo al más viejo.
`POST`	`/apps/{id}/deployments`	Despliega. Ver abajo.
`POST`	`/apps/{id}/deployments/{deployment}/cancel`	Cancela un deploy en cola o construyendo.
`GET`	`/apps/{id}/deployments/{deployment}/log`	Log del build.
`GET`	`/apps/{id}/logs`	Logs de la app.
`GET`	`/apps/{id}/metrics`	Métricas de CPU, memoria y disco.
`GET`	`/apps/{id}/domains`	Dominios propios.
`POST`	`/apps/{id}/domains/{domain}/check`	Verifica un dominio ahora.

Crear una app

{
  "project_id": "<id del proyecto>",
  "name": "mi-api",
  "source": "upload",
  "port": 3000,
  "root_dir": "",
  "env": [{ "key": "LOG_LEVEL", "value": "info" }]
}

source es upload (código subido), image (con "image": "nginx:1.29") o github. Las apps de GitHub conviene crearlas desde la consola, que resuelve la instalación y el repositorio.

Desplegar

Cuerpo	Qué despliega
`{"source": "<key>", "message": "..."}`	Una subida nueva.
`{}`	Reconstruye: la última subida, el último commit de la rama o la imagen otra vez.
`{"from": "<id de un deploy>"}`	Rollback a ese deploy, sin build.

Postgres

Método	Ruta	Qué hace
`GET`	`/postgres?project={id}`	Lista las bases.
`POST`	`/postgres`	Crea una base: `{"project_id": "...", "name": "main"}`.
`GET`	`/postgres/{id}`	Detalle y credenciales.
`PATCH`	`/postgres/{id}`	Acceso externo: `{"public": true}`.
`DELETE`	`/postgres/{id}`	Borra la base y sus datos.
`POST`	`/postgres/{id}/password`	Rota la contraseña.
`GET`	`/postgres/{id}/tables`	Tablas y vistas.
`POST`	`/postgres/{id}/query`	Corre SQL: `{"sql": "select 1"}`, o `{"sql": "...", "write": true}`.
`POST`	`/postgres/{id}/backups/run`	Hace un backup ahora.

Redis

Método	Ruta	Qué hace
`GET`	`/redis?project={id}`	Lista las instancias.
`POST`	`/redis`	Crea una instancia: `{"project_id": "...", "name": "cache"}`.
`GET`	`/redis/{id}`	Detalle y credenciales.
`PATCH`	`/redis/{id}`	Acceso externo: `{"public": true}`.
`DELETE`	`/redis/{id}`	Borra la instancia.
`POST`	`/redis/{id}/password`	Rota la contraseña.

Buckets

Método	Ruta	Qué hace
`GET`	`/buckets?project={id}`	Lista los buckets.
`POST`	`/buckets`	Crea un bucket: `{"project_id": "...", "name": "uploads"}`.
`GET`	`/buckets/{id}`	Detalle y credenciales.
`PATCH`	`/buckets/{id}`	Acceso público: `{"public": true}`.
`DELETE`	`/buckets/{id}`	Borra el bucket y sus objetos.
`POST`	`/buckets/{id}/keys`	Rota la access key.