Saltar al contenido

Docs

Cómo funciona la API, en resumen. Cada endpoint, campo y código de error está en la referencia de la API.

Abrir la referencia de la API

Dos interfaces

  • La interfaz de Rentman comprueba el token, prueba la conexión, recorre el catálogo, pasa las imágenes y reenvía solicitudes de alquiler. Está abierta en la prueba y en cada plan de pago.
  • La interfaz de licencias y actualizaciones ofrece versiones, descargas firmadas de un solo uso e informes de instalación para los productos de un plan de pago. Necesita un token vinculado a un dominio.

URL base

Cada ruta es relativa a esta URL. Las llamadas usan HTTPS y JSON, con un cuerpo de petición de 64 KiB como máximo.

https://xrentman.com/wp-json/xrentman/v1/

Tokens y etiquetas

Envía el token como Authorization: Bearer desde tu servidor. Cada cuenta tiene un token predeterminado; los tokens adicionales llevan su propia etiqueta. Un valor se muestra una sola vez, y regenerarlo conserva su id, etiqueta y dominio.

curl --fail-with-body --proto '=https' \
  -H "Authorization: Bearer $XRENTMAN_TOKEN" \
  -H 'Accept: application/json' \
  'https://xrentman.com/wp-json/xrentman/v1/me'

Límites y Retry-After

Cada token hace 60 llamadas por minuto, y una página contiene de 1 a 100 elementos. Un límite responde 429 con Retry-After en segundos: espera ese tiempo y después repite.

Documentos de problema

Cada error es un documento de problema RFC 9457. Tu código lee el code en inglés, que es estable; title y detail siguen Accept-Language. Indica el request_id cuando escribas al soporte.

Paginación con cursor

GET /catalog sin cursor inicia un ciclo de sincronización. Sigue next_cursor para leer la misma versión durante un máximo de 30 minutos, y devuelve el ETag como If-None-Match para recibir 304 cuando nada ha cambiado.

Idempotencia

POST /rental-requests usa order_id como clave, por token. Repite una solicitud dudosa con el mismo order_id y nunca con uno nuevo: la repetición devuelve la primera respuesta en lugar de crear una segunda solicitud.

Modos de reserva

Cada token tiene un modo de reserva. off, el predeterminado, responde a las solicitudes de alquiler con 403 booking_disabled; request las reenvía a Rentman. Solo el titular de la cuenta cambia el modo, en el panel.

Apps de escritorio y móviles

Un token dentro de una app de escritorio o móvil distribuida puede extraerse. Solo es aceptable para herramientas internas; si no, pon un backend propio entre la app y xRentman.

Changelog

Cada cambio de la API se puede leer por máquina en GET /wp-json/xrentman/v1/changelog, sin token.

curl --fail-with-body --proto '=https' \
  -H 'Accept: application/json' \
  'https://xrentman.com/wp-json/xrentman/v1/changelog'