API SES.Hospedajes · Ràpida, segura i llesta per a producció

Per a desenvolupadors · Llesta per a producció

API

La manera més ràpida i segura d'integrar viatgers, contractes, reserves y comunicacions oficials. Documentació clara, sandbox, webhooks i versionat estable.

Veure documentació Plans

SDK JS SDK PHP SDK Python Sandbox Webhooks Idempotència

Dissenyada per a devs

Integra en dies, dorm tranquil

Endpoints intuïtius

Recursos clars: clients, documents, reserves, contractes i comunicacions. JSON net i consistent.

Seguretat real

Claus API amb scopes, HTTPS obligatori, control d'IPs, rate limiting, auditoria i claus rotables.

SDKs i sandbox

Ambient de proves aïllat, exemples end-to-end i webhooks per a events: alta, lot enviat, acusa, error.

Crear viatger (exemple 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'
  })
})

Resposta 201 amb guest_id i traçabilitat. Reintentat (idempotent).

Comunicar lot al MIR

POST /v1/mir/batches
Authorization: Bearer 

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

Rebràs events: batch.accepted, batch.processed, batch.failed amb codis explicatius.

Obrir documentació Plans

Com integrar el teu projecte amb l'API

El teu stack, la nostra API. Aplicació nova o migració progressiva: funciona igual de bé.

Obté clau API

Des del teu panell: clau per entorn (sandbox/producció), permisos i rotació.

Connecta endpoints

Guests, documents, reservations, contracts i MIR batches amb JSON consistent.

Gestiona events

Configura webhooks per a altes, acuses, estats i errors corregibles.

Passa a producció

Versionat estable, límits clars i suport tècnic per al go-live.

Compatibilitat

REST JSON. SDKs per a JS/Node, PHP i Python.
Idempotència en POST/PUT, retry-after i paginació cursada.
Internacionalització: ES/EN en panell i payloads normalitzats.

Seguretat

HTTPS obligatori (TLS 1.2+), claus API amb permisos i expiració.
Límits de taxa per client, bloqueig d'IP i auditoria completa.
Dades a la UE; logs i PII gestionats segons RGPD.

Guia de seguretat

PMS / Channel Manager

Sincronitza hostes i reserves, genera partes i comunica automàticament al MIR.

Web de check-in

Integra el nostre pre-check-in multiidioma i rep les dades netes i validades.

Lloguer de cotxes

Puja contractes, associa conductors i dispara el lot MIR des del teu ERP.

FAQ

Preguntes freqüents

On és la documentació?

Al nostre Centre de Desenvolupadors tens guies, referència i exemples.

¿Hi ha entorn de proves?

Sí. Sandbox aïllat amb dades fictícies, claus pròpies i webhooks de test.

¿Com es versionat?

Versió major estable (v1). Els canvis incompatibles s'anuncien amb temps i rutes /v2.

Construeix sobre una API que té cura teva

Integra ràpid, opera segur i automatitza les teves comunicacions oficials.

Començar amb la documentació Plans

API