Cómo funciona la API, en resumen. Cada endpoint, campo y código de error está en 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'