API SES.Hospedajes · Rápida, segura e pronta para produção

Para desenvolvedores · Pronto para produção

API

A maneira mais rápida e segura de integrar Viajantes, contratos, reservas y Comunicações oficiais. Documentação clara, sandbox, webhooks e versionamento estável.

Consulte a documentação planos

SDK JS SDK PHP SDK Python caixa de areia Webhooks idepotência

Projetado para desenvolvedores

Integra em dias, durma em paz

terminais intuitivos

Recursos claros: convidados, documentos, reservas, contratos e comunicações. JSON limpo e consistente.

Segurança real

Chaves de API com escopos, HTTPS exigida, controle IPS, limitação de taxas, auditoria e chaves rotativas.

SDKs e Sandbox

Ambiente de teste isolado, exemplos de ponta a ponta e webhooks para eventos: alto, lote enviado, confirmação, erro.

Criar viajante (exemplo de busca)

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 com guest_id e rastreabilidade. Retinkível (idempotente).

Comunique muito ao Mir

POST /v1/mir/batches
Authorization: Bearer 

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

Você receberá eventos: batch.accepted, batch.processed, batch.failed com códigos explicativos.

Abra a documentação planos

Como integrar seu projeto com a API

Sua pilha, nossa API. Novo aplicativo ou migração progressiva: funciona tão bem.

Obtenha a chave da API

No seu painel: chave por ambiente (sandbox/produção), escopos e rotação.

Conecte os pontos de extremidade

Convidados, documentos, reservas, contratos e lotes MIR com JSON consistente.

Gerenciar eventos

Configure webhooks para registros, reconhecimentos, status e erros de correção.

vai para a produção

Versionamento estável, limites claros e suporte técnico para Go-Live.

Compatibilidade

Descanse JSON. SDKs para JS/Node, PHP e Python.
idempotência em post/put, retry-after e paginação concluída.
Internacionalização: ES/PT em painéis padronizados e cargas úteis.

Segurança

HTTPS obrigatório (TLS 1.2+), chaves de API com escopos e expiração.
Limites de taxa por cliente, bloqueio de IP e auditoria completa.
dados na UE; Logs e PII gerenciados de acordo com o GDPR.

Guia de segurança

PMS / Channel Manager

Sincronize convidados e reservas, gere peças e comunique-se automaticamente ao MiR.

Site de check-in

Ele integra nosso pré-check-in multilíngue e recebe os dados limpos e validados.

Alugue um carro

Faça upload de contratos, associe os motoristas e atire no lote MIR do seu ERP.

FAQ

Perguntas frequentes

Onde está a documentação?

no nosso Centro do desenvolvedor Você tem guias, referências e exemplos.

Existe um ambiente de teste?

Sim. Sandbox isolado com dados fictícios, chaves próprias e webhooks de teste.

Como é versionado?

Versão principal estável (v1). As alterações incompatíveis são anunciadas com o tempo e as rotas /v2.

Construa em uma API que cuida de você

Integre rapidamente, opere seguro e automatize suas comunicações oficiais.

Comece com os documentos planos

API