Desenvolva sobre a mesma API em que a Camping.care funciona
Cada parte da Camping.care funciona sobre uma API REST documentada, e tem acesso a toda ela: 583 endpoints em 43 APIs. Crie o seu próprio motor de reservas, ligue o seu hardware, ou coloque a sua app diretamente nos ecrãs que a equipa do parque usa todos os dias.
curl "https://api.camping.care/v21/reservations?limit=2" \ -H "Accept: application/json" \ -H "Authorization: Bearer {secret_key}"HTTP/1.1 200 OK[ { "id": 1000, "reservation_id": 1, "accommodation_id": 3000, "status": "confirmed", "payment": "paid", "arrival": "2026-07-14 12:00:00", "departure": "2026-07-21 11:59:59", "total": 496 }, // …]- 583
- 43
- 400+
- 7
O ecrã é apenas um dos clientes
Numa configuração clássica, os ecrãs, a lógica de negócio e a base de dados são um só produto, e tudo o resto recebe uma exportação. Numa plataforma API-first e headless, os dados e a lógica ficam atrás de uma API documentada, e cada ecrã, incluindo os nossos, é um cliente dela. Os front ends podem ser acrescentados, trocados ou criados por si, sem que ninguém mexa no núcleo.
- Ecrãs, lógica e dados são construídos como um só bloco. Os ecrãs do próprio fornecedor são a única porta de entrada.
- Os outros sistemas recebem exportações CSV, sincronizações noturnas ou um plug-in feito à medida, por isso estão sempre umas horas atrasados.
- Uma nova ligação é um pedido de funcionalidade na fila de outra pessoa.
- Os dados e a lógica ficam atrás de uma API REST documentada. A própria app Camping.care é apenas um cliente dela.
- O seu site, um quiosque, um canal ou um agente de IA falam com a mesma API em tempo real, e recebem resposta através de webhooks.
- Uma nova ligação é uma tarde de código (por nós, por um parceiro ou por si).
A nossa app usa a mesma API que você
Não há porta das traseiras privada. Os ecrãs que os donos de parques usam todos os dias são construídos sobre os 583 endpoints da referência pública, por isso, se a nossa interface o consegue fazer, o seu código também consegue.
Traga o seu próprio front end
Crie um motor de reservas com o design do seu site, um fluxo de quiosque ou uma app para hóspedes. A plataforma trata da disponibilidade, dos preços e dos pagamentos; você decide o que o hóspede vê.
Em tempo real, não esta noite
Os webhooks avisam o seu sistema no momento em que é feita uma reserva, um hóspede faz check-in, uma fatura é finalizada ou chega um pagamento, assinados com HMAC-SHA256 e reenviados se o seu endpoint estiver em baixo.
583 endpoints em 43 APIs
Tudo o que a plataforma faz está na referência, desde uma única reserva até ao contador de eletricidade do lugar 42. Aqui agrupado pelo que provavelmente vai construir.
Reservas e marcações
Reservations API
58 endpointsAvailability API
4 endpointsPrice Calculation API
12 endpointsCache API
3 endpointsChannels API
5 endpointsiCals API
5 endpointsWidgets API
4 endpointsVouchers API
9 endpoints
Hóspedes
Contacts API
20 endpointsReviews API
5 endpointsDocuments API
12 endpointsEmail API
6 endpointsLicense plates API
6 endpointsCode API
12 endpointsBalances API
12 endpoints
Alojamentos e preços
Accommodations API
54 endpointsTypes API
35 endpointsCategories API
10 endpointsRates API
18 endpointsProducts API
22 endpointsExchange rates API
2 endpoints
Dinheiro
Invoices API
23 endpointsPayments API
24 endpointsLedgers API
9 endpoints
Operações
Tasks API
23 endpointsWorkflows API
10 endpointsDevices API
11 endpointsKiosk API
9 endpointsEnergies API
6 endpointsNotifications API
2 endpoints
Plataforma
Administrations API
80 endpointsUsers API
9 endpointsApps API
14 endpointsOAuth 2 API
2 endpointsWebhooks API
8 endpointsFields API
19 endpointsTags API
5 endpointsMedia API
7 endpointsTranslations API
3 endpointsTimezones API
1 endpointAudit API
1 endpointLogs API
1 endpointAPI status
2 endpoints
Apps que vivem dentro da interface, não ao lado dela
A App Store é onde os parques de campismo instalam as suas integrações, e qualquer pessoa pode desenvolver para ela. A sua app corre isolada dentro da Camping.care, escrita em qualquer linguagem e alojada no seu próprio domínio, e regista widgets nos sítios onde a equipa já trabalha.
Qualquer linguagem, o seu próprio alojamento
Uma app é um URL. Carregamo-la numa frame isolada, por isso pode ser Laravel, Vue ou o que quer que já use, no seu próprio domínio.
Instalada com consentimento, com login por OAuth 2.0
Quando um parque instala a sua app, aprova os scopes que pede. Recebe um authtoken e troca-o por acesso à API, para que ninguém ande a enviar chaves de API por e-mail.
Um parque, alguns, ou todos
Publique uma app em privado para um único parque, para um grupo à sua escolha, ou para todos os parques da plataforma.
Fala de volta com a interface
Os widgets enviam uma mensagem para definir a sua própria altura, ou para atualizar a reserva ou o hóspede onde estão depois de a sua app o ter alterado através da API.
Sete sítios onde uma app pode aparecer
Cada widget é carregado com o ID da reserva ou do hóspede onde está, o idioma do utilizador e um authtoken para chamar a API como o utilizador com sessão iniciada.
- Página da app
- Dashboard
- Reserva
- Separador da reserva
- Contacto
- Separador do contacto
- Formulário de reserva online
// Ajusta a altura do widget ao conteúdo e recarrega a// reserva que a sua app acabou de alterar através da API.window.top.postMessage({ height: document.body.scrollHeight, refresh: true}, '*');Quatro formas de autenticação, uma para cada tipo de cliente
Cada chave, app e token pertence ao seu próprio utilizador com os seus próprios scopes, por isso cada chamada pode ser rastreada até quem (ou o quê) a fez.
Chave pública
Segura para usar num browser. Lê o que um hóspede pode ver (o parque, os alojamentos, a disponibilidade e os preços) e é aquilo sobre o qual funciona um motor de reservas online.
Chave secreta
Acesso servidor a servidor, enviado como Bearer token. Crie quantas precisar; cada uma torna-se um utilizador com exatamente os scopes que lhe der. Nunca a coloque num browser.
OAuth 2.0
O parque aprova os scopes da sua app na instalação. Troca o authtoken por um token válido durante uma hora e renova-o à medida que avança. Um cabeçalho indica em que parque está a trabalhar.
Com base na reserva
Inicia a sessão de um hóspede com a sua própria reserva, e abre apenas essa reserva. Feito para páginas de a-minha-reserva, check-in online e apps para hóspedes.
curl "https://api.camping.care/v21/users/me" \ -H "Accept: application/json" \ -H "Authorization: Bearer {secret_key}"Cada endpoint tem o seu próprio scope
Há mais de 400 scopes, um para cada coisa que a API consegue fazer. Dê a uma app ou a uma chave exatamente os direitos de que o seu trabalho precisa, e ela não consegue aceder a mais nenhum dado.
- Os scopes são por endpoint. Ler uma reserva, listar reservas e adicionar uma são três direitos distintos.
- Definidos por chave de API, por app e por utilizador. Uma integração de fechaduras nunca precisa de ver as suas faturas.
- Os parques veem e aprovam os scopes que uma app pede antes de a instalarem.
- O registo de auditoria guarda todas as ações, quer tenham sido feitas por um membro da equipa quer pela API.
Bom saber antes de começar
- REST e JSON
- 120 chamadas por minuto
- Webhooks assinados
- HTTPS e UTC