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

Per gli sviluppatori · Pronto per la produzione

API

Il modo più veloce e sicuro per integrarsi Viaggiatori, contratti, prenotazioni y Comunicazioni ufficiali. Documentazione chiara, sandbox, webhook e versione stabile.

Vedi documentazione piani

SDK JS SDK PHP SDK Python buca della sabbia Webhooks Idepotenza

Progettato per gli sviluppatori

Integra in giorni, dormi sonni tranquilli

Endpoint intuitivi

Risorse chiare: ospiti, documenti, prenotazioni, contratti e comunicazioni. JSON pulito e coerente.

Vera sicurezza

Chiavi API con ambiti, HTTPS, controllo IPS, limitazione della velocità, audit e chiavi rotanti.

SDK e sandbox

Ambiente di test isolato, esempi end-to-end e webhook per eventi: registrazione, lotto inviato, ricevuta, errore.

Crea viaggiatore (Esempio di recupero)

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'
  })
})

Rispondi 201 con guest_id e tracciabilità. Retinkable (idempotente).

comunicare molto a Mir

POST /v1/mir/batches
Authorization: Bearer 

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

Riceverai eventi: batch.accepted, batch.processed, batch.failed con codici esplicativi.

Documentazione aperta piani

Come integrare il tuo progetto con l'API

Il tuo stack, la nostra API. Nuova app o migrazione progressiva: funziona altrettanto bene.

Ottieni la chiave API

Dal tuo pannello: chiave per ambiente (sandbox/produzione), ambiti e rotazione.

Collega gli endpoint

Ospiti, documenti, prenotazioni, contratti e lotti MIR con JSON coerente.

gestire gli eventi

Configura i webhook per registrazioni, riconoscimenti, stati ed errori risolvibili.

va in produzione

Versione stabile, limiti chiari e supporto tecnico per Go-Live.

Compatibilità

Riposa JSON. SDK per JS/Node, PHP e Python.
idempotenza in post/put, retry-after e impaginazione completata.
Internazionalizzazione: ES/EN in pannelli standardizzati e payload.

Sicurezza

HTTPS richiesto (TLS 1.2+), chiavi API con ambiti e scadenza.
Limiti di tariffa per client, blocco IP e controllo completo.
dati nell'UE; Log e PII gestiti secondo GDPR.

Guida alla sicurezza

PMS / Channel Manager

Sincronizza gli ospiti e le prenotazioni, genera parti e comunica automaticamente al MiR.

Sito web per il check-in

Integra il nostro pre-check-in multilingua e riceve i dati puliti e convalidati.

Affittare una macchina

Carica contratti, associa i driver e spara il lotto MIR dal tuo ERP.

FAQ

Domande frequenti

Dov'è la documentazione?

nel nostro Centro per sviluppatori Hai guide, riferimenti ed esempi.

Esiste un ambiente di prova?

si. Sandbox isolato con dati fittizi, chiavi proprie e webhook di prova.

Come viene versione?

Versione principale stabile (V1). Le modifiche incompatibili vengono annunciate con il tempo e le rotte /v2.

Costruisci su un'API che si prende cura di te

Integra velocemente, opera in sicurezza e automatizza le tue comunicazioni ufficiali.

Inizia con i documenti piani

API