API SES.Hospedajes · Rápida, segura y lista para producción

Para desarrolladores · Listo para producción

API

La forma más rápida y segura de integrar viajeros, contratos, reservas y comunicaciones oficiales. Documentación clara, sandbox, webhooks y versionado estable.

Ver documentación Planes

SDK JS SDK PHP SDK Python Sandbox Webhooks Idempotency

Diseñada para devs

Integra en días, duerme tranquilo

Endpoints intuitivos

Recursos claros: huéspedes, documentos, reservas, contratos y comunicaciones. JSON limpio y consistente.

Seguridad real

API keys con scopes, HTTPS obligatorio, control de IPs, rate limiting, auditoría y claves rotables.

SDKs & sandbox

Ambiente de pruebas aislado, ejemplos end-to-end y webhooks para eventos: alta, lote enviado, acuse, error.

Crear viajero (ejemplo fetch)

await fetch('https://api.seshospedajes.es/v1/guests', {
  method:'POST',
  headers:{
    'Authorization':'Bearer ',
    'Content-Type':'application/json',
    'Idempotency-Key':'a1b2c3-unique-123'
  },
  body:JSON.stringify({
    first_name:'Ana', last_name:'Gómez',
    document:{type:'DNI', number:'12345678A'},
    nationality:'ES', birth_date:'1992-03-12'
  })
})

Respuesta 201 con guest_id y trazabilidad. Reintentable (idempotente).

Comunicar lote al MIR

POST /v1/mir/batches
Authorization: Bearer 

{
  "type":"PV",                 // PV, RH, AV, RV
  "xml":"",    // ZIP + base64
  "callback_url":"https://tuservidor.com/webhooks/mir"
}

Recibirás eventos: batch.accepted, batch.processed, batch.failed con códigos explicativos.

Abrir documentación Planes

Cómo integrar tu proyecto con la API

Tu stack, nuestra API. Nueva app o migración progresiva: funciona igual de bien.

Obtén API key

Desde tu panel: clave por entorno (sandbox/producción), scopes y rotación.

Conecta endpoints

Guests, documents, reservations, contracts y MIR batches con JSON consistente.

Gestiona eventos

Configura webhooks para altas, acuses, estados y errores corregibles.

Pasa a producción

Versionado estable, límites claros y soporte técnico para go-live.

Compatibilidad

REST JSON. SDKs para JS/Node, PHP y Python.
Idempotencia en POST/PUT, retry-after y paginación cursada.
Internacionalización: ES/EN en panel y payloads normalizados.

Seguridad

HTTPS obligatorio (TLS 1.2+), API keys con scopes y expiración.
Rate limits por cliente, bloqueo de IP y auditoría completa.
Datos en la UE; logs y PII gestionados según RGPD.

Guía de seguridad

PMS / Channel Manager

Sincroniza huéspedes y reservas, genera partes y comunica automáticamente al MIR.

Web de check-in

Integra nuestro pre-check-in multi-idioma y recibe los datos limpios y validados.

Rent a Car

Sube contratos, asocia conductores y dispara el lote MIR desde tu ERP.

FAQ

Preguntas frecuentes

¿Dónde está la documentación?

En nuestro Centro de Desarrolladores tienes guías, referencia y ejemplos.

¿Hay entorno de pruebas?

Sí. Sandbox aislado con datos ficticios, claves propias y webhooks de test.

¿Cómo se versiona?

Versión mayor estable (v1). Cambios incompatibles se anuncian con tiempo y rutas /v2.

Construye sobre una API que te cuida

Integra rápido, opera seguro y automatiza tus comunicaciones oficiales.

Empezar con la docs Planes

API