Empezar

Herramientas para desarrolladores: tokens de API, la API REST, la CLI y «Explicar este error».

Crea tokens de API con el alcance adecuado, trabaja con las aplicaciones desde scripts y CI mediante la API REST y la línea de comandos rivervo, y recibe explicaciones con AI de los despliegues fallidos.

4 MIN DE LECTURA

Todo lo que haces con las aplicaciones en el panel también se puede automatizar: despliegues desde CI, variables desde un script, registros en tu terminal.

Tokens de API

Ajustes de la cuenta → Tokens de API → Crear un token. Ponle un nombre (dónde se usa, por ejemplo «GitHub Actions») y elige qué puede hacer:

AlcancePermite
Solo lecturaaplicaciones, despliegues y sus registros, registros de ejecución, dominios
Lectura y desplieguelectura y, además, desplegar, revertir y reiniciar
Acceso completodespliegue y, además, variables (leer y cambiar) y dominios (añadir, quitar)
Acceso completo y terminalacceso completo y, además, comandos en tus sitios web, sus archivos, tareas cron, claves SSH y despliegues desde Git

También puedes fijar cuándo caduca: a los 30, 90 o 365 días, o nunca.

  • El token se muestra una sola vez: cópialo en ese momento.
  • Un token actúa con tu acceso. En la cuenta de otra persona actúa con tu rol en la aplicación, y encima se aplica el alcance del token. Consulta Acceso a una aplicación.
  • Puedes tener hasta 20 tokens. Revocar desactiva un token al momento.
  • Solo tú puedes crear tus tokens: alguien que haya entrado en tu cuenta en tu nombre no puede.

La API REST

La API está documentada en OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Impórtala en Postman, Insomnia o un generador de código.

Dirección base: https://api.rivervo.com/api/v1. Envía el token como bearer token:

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

Qué puedes hacer:

Método y rutaQué haceAlcance
GET /appstus aplicaciones y sus servicioslectura
GET /apps/{id}una aplicaciónlectura
GET /apps/{id}/deploymentssus despliegueslectura
POST /apps/{id}/deploymentsdesplegar: compila el último commit o, con {"rebuild": false}, despliega de nuevo la versión actualdespliegue
GET /apps/{id}/deployments/{deployment}un despliegue con su registro de compilaciónlectura
POST /apps/{id}/deployments/{deployment}/rollbackvolver a esa versióndespliegue
POST /apps/{id}/restartreiniciardespliegue
GET /apps/{id}/logsregistros de ejecución del sitio, de un worker o de las tareas programadaslectura
GET, PUT, PATCH /apps/{id}/envleer, sustituir o actualizar variablescompleto
GET /apps/{id}/domainsdominioslectura
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}añadir o quitar un dominiocompleto
  • La cuenta de otra persona: añade la cabecera X-Account: <the account's customer ID> (el ID de cliente de esa cuenta) para trabajar con las aplicaciones de una cuenta a la que te han dado acceso.
  • Límites: 120 peticiones por minuto y persona, de ellas 30 de cambios. Si los superas, la API responde 429 con Retry-After.
  • Idioma: por defecto, los mensajes llegan en inglés; envía Accept-Language: az o ru para recibirlos en azerí o en ruso.
  • Las variables cambiadas por la API llegan a la aplicación con su siguiente despliegue, como en el panel: basta con {"rebuild": false}.

La línea de comandos rivervo

Despliegues, registros, variables y reversiones desde tu terminal, con los mismos tokens de API. Necesita Node.js 22 o posterior:

npm install -g rivervo
rivervo login                       # paste the token
rivervo deploy shop                 # build the latest commit and follow the deploy
rivervo logs shop -f                # follow the application's output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # back to the previous version

En CI lee el token de la variable RIVERVO_TOKEN, y deploy termina con error cuando la nueva versión no se publica, así que puede servir de control en un pipeline. Mientras no esté publicada, puedes hacer lo mismo con la API REST.

«Explicar este error»

Cuando un despliegue no termina o un servicio deja de funcionar, junto al registro aparece Explicar este error. Lee las últimas líneas del registro y te dice, en tu idioma:

  • Causa probable: qué ha fallado;
  • Cómo solucionarlo: pasos concretos para tu stack.

La explicación la escribe AI a partir del registro; revísala antes de cambiar nada. Antes de enviar nada, ocultamos en el registro todos los valores de tus variables y todo lo que parezca una clave, una contraseña o un token. Tu código y tus variables en sí nunca se envían.

Cada persona puede pedir hasta 10 explicaciones nuevas al día; una explicación ya hecha para el mismo registro se vuelve a mostrar gratis.

Rivervo MCP

También puedes trabajar con tus aplicaciones desde asistentes de AI con Rivervo MCP. Funciona con Claude, ChatGPT, Cursor, VS Code y otras aplicaciones compatibles con MCP: pregunta por despliegues, registros y errores en una conversación y deja que el asistente despliegue o revierta por ti. No necesitas token; inicias sesión con tu cuenta de Rivervo. Consulta Rivervo MCP.

¿Sigues con dudas?

Escríbenos por chat: la AI responde al momento y un ingeniero se une cuando hace falta, a cualquier hora del día.

Contactar con soporte