Crea junto a ElefyMove
Conecta tu plataforma con ElefyMove: publica propiedades, sincroniza la disponibilidad en tiempo real y evita por completo la doble reserva de una misma fecha.
Qué permite hacer la API
Un único punto de integración para propiedades, disponibilidad y sincronización en tiempo real.
API de propiedades
Envía anuncios de propiedades multilingües a ElefyMove. Puedes enviar contenido en cualquier subconjunto de nuestros 9 idiomas; cada anuncio se modera antes de publicarse.
Sincronización de disponibilidad
El calendario maestro de ElefyMove es la única fuente de verdad para todo lo que se puede reservar en la plataforma. Cada rango de fechas tiene un estado: disponible, retenido, reservado o bloqueado; los márgenes de limpieza se aplican de forma centralizada para que ningún canal pueda generar una doble reserva.
Retenciones temporales
Crea una retención de corta duración, de hasta 10 minutos, mientras el huésped completa el pago en tu plataforma. Los conflictos se resuelven por orden de llegada, y la solicitud perdedora recibe una respuesta 409 legible por máquina.
Webhooks
Suscríbete a eventos firmados con HMAC-SHA256 sobre aprobaciones de anuncios, cambios de disponibilidad, el ciclo de vida de las retenciones y el estado de las reservas, entregados casi en tiempo real. Los payloads solo contienen fechas y referencias, nunca datos personales del huésped.
Sincronización iCal
Cada anuncio exporta un feed iCal firmado, y ElefyMove también puede consultar periódicamente tu propio feed, de modo que los bloqueos externos se reflejan en ambos sistemas sin necesidad de escribir código de integración.
Qué pueden hacer los socios — y qué no
Regla cero: toda operación se limita a tus propios datos. No existe ningún acceso entre socios, en ninguna dirección.
Puedes
- Crear, actualizar y retirar tus propios anuncios de propiedades, en cualquiera de nuestros 9 idiomas
- Consultar tus propios anuncios y su estado de moderación
- Consultar la disponibilidad de tus propios anuncios y registrar bloqueos de canal externo con una referencia
- Crear y liberar retenciones temporales, de hasta 10 minutos, durante tu proceso de pago
- Registrar webhooks y recibir eventos firmados — solo fechas y referencias
- Exportar calendarios de anuncios (iCal) y registrar tus propios feeds de iCal
- Consultar la jerarquía de ubicaciones pública
No puedes
- Mover ningún pago, reembolso o depósito a través de esta API
- Crear reservas o contratos de ElefyMove — una reserva externa solo se registra como un bloqueo de calendario
- Enviar ni recibir datos personales de huéspedes o inquilinos
- Acceder ni modificar los anuncios, retenciones, bloqueos o configuración de otro socio
- Enviar mensajes, contactar o captar a usuarios de ElefyMove
- Consultar o republicar anuncios que no te pertenecen
- Superar los límites de solicitudes, compartir claves o automatizar la creación de cuentas
Cómo obtener acceso
Crea una cuenta de desarrollador, verifica tu correo y emite tus propias claves API directamente desde el panel. Para publicar anuncios reales, el equipo de ElefyMove además debe vincular tu clave a una cuenta de propietario verificada.
Crea tus claves APIAl crear una cuenta, aceptas las Condiciones de uso de la API.
Ámbitos disponibles
listings:readlistings:writeavailability:readavailability:writeholds:writewebhooks:manageLímite de solicitudes por defecto: 120 solicitudes por minuto por clave.
Guía rápida
Cada solicitud se autentica con una cabecera X-Api-Key que contiene tu clave asignada.
Consultar la disponibilidad de un anuncio
curl "https://elefymove.com/api/public/v1/listings/{listingId}/availability?from=2026-09-01&to=2026-09-30" \
-H "X-Api-Key: efy_live_xxxxxxxxxxxxxxxxxxxxxxxx"
# Response — 200 OK
[
{ "from": "2026-09-01", "to": "2026-09-14", "state": "AVAILABLE" },
{ "from": "2026-09-15", "to": "2026-09-20", "state": "BLOCKED", "source": "partner-site", "externalRef": "HMXYZ123" },
{ "from": "2026-09-21", "to": "2026-09-30", "state": "AVAILABLE" }
]Crear una retención temporal
curl -X POST "https://elefymove.com/api/public/v1/listings/{listingId}/holds" \
-H "X-Api-Key: efy_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"from": "2026-09-15", "to": "2026-09-20", "ttlSeconds": 300}'
# Response — 201 Created
{ "holdId": "hld_9f3a2c1b", "expiresAt": "2026-08-13T10:15:00Z" }La solicitud perdedora recibe una respuesta 409 legible por máquina
# Same request, the dates were just taken by another channel
# Response — 409 Conflict
{
"code": "SLOT_TAKEN",
"conflictingState": "HELD",
"wonBy": "external"
}Referencia completa de la API
Todos los esquemas de petición y respuesta, los formatos de error y los ejemplos están en la referencia interactiva de OpenAPI: prueba cualquier endpoint en directo con tu propia clave.
Abrir documentación de la APIConsultar la documentación completaTodos los endpoints de un vistazo
La superficie completa de Open API v1. Cada petición lleva tu clave en la cabecera X-Api-Key y cada ruta accede únicamente a tus propios datos.
URL base https://elefymove.com
Anuncios
| Método | Endpoint | Ámbito | Qué hace |
|---|---|---|---|
/api/public/v1/listings | listings:write | Envía un anuncio nuevo a moderación, con el contenido en los idiomas que quieras de los 9 admitidos. | |
| GET | /api/public/v1/listings | listings:read | Lista todos los anuncios de tu clave con su estado de moderación actual. |
| GET | /api/public/v1/listings/{externalId} | listings:read | Consulta uno de tus anuncios por el ID externo que le asignaste. |
| PATCH | /api/public/v1/listings/{externalId} | listings:write | Actualiza uno de tus anuncios; los campos que omitas se mantienen igual. |
| DELETE | /api/public/v1/listings/{externalId} | listings:write | Retira uno de tus anuncios. |
Disponibilidad y bloqueos
| Método | Endpoint | Ámbito | Qué hace |
|---|---|---|---|
| GET | /api/public/v1/listings/{id}/availability | availability:read | Consulta el calendario unificado de un anuncio en un rango de fechas: disponible, retenido, reservado o bloqueado. |
/api/public/v1/listings/{id}/blocks | availability:write | Crea o actualiza un bloqueo de canal externo identificado con tu propia referencia. | |
| DELETE | /api/public/v1/listings/{id}/blocks/{externalRef} | availability:write | Elimina un bloqueo de canal externo que hayas creado. |
Reservas temporales
| Método | Endpoint | Ámbito | Qué hace |
|---|---|---|---|
/api/public/v1/listings/{id}/holds | holds:write | Retén un rango de fechas mientras el huésped completa el pago en tu plataforma. La petición perdedora recibe un 409 con SLOT_TAKEN. | |
| DELETE | /api/public/v1/holds/{id} | holds:write | Libera una de tus retenciones antes de que caduque. |
Sincronización de calendario (iCal)
| Método | Endpoint | Ámbito | Qué hace |
|---|---|---|---|
| GET | /api/public/v1/listings/{id}/calendar.ics | URL firmada, sin clave | Descarga el calendario de un anuncio como feed iCal. El token firmado de la URL es la autenticación, así que cualquier app de calendario puede suscribirse directamente. |
| PUT | /api/public/v1/listings/{id}/ical-sources | availability:write | Registra o sustituye el feed iCal entrante que ElefyMove consulta para uno de tus anuncios. |
| GET | /api/public/v1/listings/{id}/ical-sources | availability:read | Consulta el feed registrado de un anuncio, con su estado de sincronización y el último error. |
| DELETE | /api/public/v1/listings/{id}/ical-sources | availability:write | Deja de consultar y elimina el feed registrado de un anuncio. |
Webhooks
En la v1 los webhooks no tienen un endpoint que el partner pueda llamar. Envíanos la URL de destino al solicitar tu clave y el equipo de ElefyMove la registra junto con el secreto HMAC-SHA256 con el que se firma cada envío. Los envíos fallidos se reintentan con espera progresiva y el contenido incluye solo fechas y referencias.
Eventos que puedes recibir
listing.approvedlisting.rejectedavailability.changedhold.createdhold.releasedhold.expiredbooking.createdbooking.cancelledpingGeneral
| Método | Endpoint | Ámbito | Qué hace |
|---|---|---|---|
| GET | /api/public/v1/ping | Cualquier clave válida | Comprueba que tu clave funciona y consulta el nombre de cliente y los ámbitos asociados. |
Datos y uso responsable
- Ningún dato personal del huésped circula por la API: los bloqueos externos solo incluyen fechas y una referencia, conforme a la PDPA de Tailandia.
- Los anuncios obtenidos a través de la API enlazan siempre con su página canónica en elefymove.com.
- Las claves tienen un alcance definido y el equipo de ElefyMove puede revocarlas en cualquier momento.
API abierta v1 — actualmente en proceso de incorporación de socios de integración.