Referência da API Newhotel Cloud
Guia técnico da API Newhotel Cloud utilizada pelos módulos CloudNewhotel — endpoints, autenticação, rate limiting, webhooks e ambientes de sandbox.
§Endpoints principais
| Endpoint | Método | Descrição |
|---|---|---|
| /v2/reservations | GET / POST / PATCH | Gestão de reservas directas e via canal |
| /v2/inventory | GET / PATCH | Disponibilidade e restrições por tipologia |
| /v2/rates | GET / POST / PATCH | Tarifas base e tarifas derivadas |
| /v2/folios | GET / POST | Folhas de cliente e encerramento |
| /v2/invoices | GET / POST | Emissão de factura AT-compliant |
| /v2/guests | GET / POST / PATCH | Perfis de hóspedes e boletim SEF |
| /v2/webhooks | GET / POST / DELETE | Subscrição de eventos push |
§Autenticação
Autenticação por OAuth 2.0 delegado a partir da Área de cliente. O fluxo suportado é o Client Credentials Grant, com tokens de acesso válidos por 60 minutos e refresh tokens por 30 dias.
§Rate limiting
Limites padrão: 60 pedidos por minuto por token, 5000 pedidos por hora por propriedade. Pedidos que excedam o limite recebem HTTP 429 com cabeçalho Retry-After em segundos. Conta Enterprise sobe os limites para 300/min e 25000/h.
§Sandbox
Ambiente de sandbox disponível em sandbox.cloudnewhotel.com com dados de teste sintéticos. As credenciais de sandbox não conferem acesso ao ambiente de produção. O sandbox reinicia-se ao domingo à meia-noite.