Documentación para desarrolladores

Espacio de trabajo de la API
https://api.rentron.xyz/v1
Esquema OpenAPI

Opciones

// GET

API de producción

Opciones de alquiler

Consulta las cantidades de Energy válidas, las duraciones de alquiler y si se aceptan pedidos ahora mismo.

GET /v1/energy/options
En esta página

Llama a este endpoint antes de dibujar un formulario de pedido, o guárdalo en caché durante poco tiempo. Estos valores los controla el servidor y no deben quedar fijos en el código.

Respuesta 200

{"energy_per_portion":65000,"max_energy":1300000,"duration_minutes":[15,60,240,1440],"intake_enabled":true}
Campo Tipo Descripción
energy_per_portion entero Tamaño de una porción de Energy.
max_energy entero Energy máxima en un solo pedido.
duration_minutes entero[] Duraciones de alquiler permitidas, en minutos.
intake_enabled booleano true mientras se aceptan pedidos nuevos.

Validación en el cliente

energy tiene que ser positivo, no mayor que max_energy y divisible por energy_per_portion. duration_minutes tiene que coincidir exactamente con un elemento de la respuesta.

El servidor sigue siendo la fuente de la verdad, porque las opciones pueden cambiar entre esta petición y la creación del pedido.

Errores

Los estados posibles son 401, 429, 500 y 503, todos con el formato compartido de Problem Details.