Ir para o conteúdo principal
Vai desenvolver sobre a Camping.care?

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.

GET /v21/reservations
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  },  // …]
endpoints documentados
583
APIs, das reservas à energia
43
scopes, um por endpoint
400+
sítios onde uma app pode aparecer
7
O que significa realmente API-first?

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.

Configuração cloud clássica
  • 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.
API-first, headless
  • 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.

A que pode aceder?

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 endpoints

    Ler, criar e alterar reservas (hóspedes, lugares, opções, noites, estado e condições de pagamento), além de PDFs e relatórios.

  • Availability API

    4 endpoints

    Verificar que lugares e categorias estão livres num período, antes de criar a reserva.

  • Price Calculation API

    12 endpoints

    Calcular o preço exato de uma estadia, com hóspedes extra, opções obrigatórias, códigos promocionais, cartões de desconto e impostos.

  • Cache API

    3 endpoints

    Obter em massa a disponibilidade e os preços para um intervalo de datas, para que uma agência de viagens online possa calcular preços a partir da sua própria base de dados.

  • Channels API

    5 endpoints

    A origem de cada reserva: direta, Booking.com, Airbnb e os restantes.

  • iCals API

    5 endpoints

    Sincronizar reservas de calendários externos, como o Airbnb e a Booking.com, através de feeds iCal.

  • Widgets API

    4 endpoints

    Gerir os widgets de reserva integrados no seu site.

  • Vouchers API

    9 endpoints

    Vales de desconto que os hóspedes podem usar ao reservar.

Hóspedes

  • Contacts API

    20 endpoints

    Registos de hóspedes, únicos por endereço de e-mail, com etiquetas, campos personalizados e mapeamentos.

  • Reviews API

    5 endpoints

    As avaliações que os hóspedes deixam depois da estadia.

  • Documents API

    12 endpoints

    Modelos de documentos e documentos que os hóspedes assinam, como contratos e termos e condições.

  • Email API

    6 endpoints

    Modelos de e-mail, e e-mails transacionais enviados aos hóspedes.

  • License plates API

    6 endpoints

    Matrículas de veículos associadas a hóspedes e reservas, para barreiras e câmaras de leitura de matrículas.

  • Code API

    12 endpoints

    Códigos de acesso para o portão, o WiFi, as fechaduras e o check-in.

  • Balances API

    12 endpoints

    Contas pré-pagas que os hóspedes carregam e gastam no parque.

Alojamentos e preços

  • Accommodations API

    54 endpoints

    Tudo o que aluga: descrições, multimédia, lugares, extras, etiquetas e as tarifas associadas.

  • Types API

    35 endpoints

    Tipos de lugar, desde o lugar para tenda e o lugar para caravana até ao pod de glamping e ao chalé, e as unidades por trás deles.

  • Categories API

    10 endpoints

    Grupos de tipos de lugar, usados pela pesquisa de disponibilidade e pelos widgets de reserva.

  • Rates API

    18 endpoints

    Preços por noite com períodos baseados em datas.

  • Products API

    22 endpoints

    Extras faturáveis numa reserva (taxa turística, roupa de cama, pequeno-almoço), com extras e promoções.

  • Exchange rates API

    2 endpoints

    Taxas de câmbio, para preços em mais do que uma moeda.

Dinheiro

  • Invoices API

    23 endpoints

    Faturas com as suas linhas e etiquetas, em PDF, com um código QR de pagamento ou em UBL para o seu contabilista.

  • Payments API

    24 endpoints

    Pagamentos, os fornecedores e métodos de pagamento por trás deles, e recibos em PDF.

  • Ledgers API

    9 endpoints

    Contas do razão e mapeamentos, para que a contabilidade aconteça automaticamente.

Operações

  • Tasks API

    23 endpoints

    Tarefas de limpeza e manutenção, criadas a partir de modelos, atribuídas à equipa e acompanhadas até estarem concluídas.

  • Workflows API

    10 endpoints

    Automatizações que correm quando algo acontece, como uma chegada ou um pagamento.

  • Devices API

    11 endpoints

    O hardware no parque: terminais de quiosque, leitores no portão e cloud connectors.

  • Kiosk API

    9 endpoints

    Quiosques de check-in self-service no seu parque.

  • Energies API

    6 endpoints

    Leituras dos contadores de eletricidade nos lugares com eletricidade, e a fatura de energia que se segue.

  • Notifications API

    2 endpoints

    Notificações na app para a sua equipa.

Plataforma

  • Administrations API

    80 endpoints

    Os seus parques e as respetivas definições: utilizadores, funções, tabelas de idades e de IVA, lugares, cartões, chaves de API, multimédia e parceiros.

  • Users API

    9 endpoints

    Contas da equipa e respetivos direitos.

  • Apps API

    14 endpoints

    As apps da App Store, as suas versões e as administrações em que estão instaladas.

  • OAuth 2 API

    2 endpoints

    Trocar o authtoken de uma app por um access token, e renová-lo.

  • Webhooks API

    8 endpoints

    Notificações de eventos em tempo real enviadas para o seu endpoint HTTPS, assinadas com HMAC-SHA256.

  • Fields API

    19 endpoints

    Campos e formulários personalizados para hóspedes e reservas.

  • Tags API

    5 endpoints

    Etiquetas com cores para reservas, hóspedes e pagamentos.

  • Media API

    7 endpoints

    Carregar imagens e ficheiros, e associá-los onde pertencem.

  • Translations API

    3 endpoints

    Textos da interface em todos os idiomas suportados.

  • Timezones API

    1 endpoint

    Os fusos horários que a plataforma suporta.

  • Audit API

    1 endpoint

    O registo de auditoria de todas as ações, feitas pela equipa ou pela API.

  • Logs API

    1 endpoint

    Escrever as suas próprias entradas de registo a partir de uma integração.

  • API status

    2 endpoints

    A versão da API e uma verificação de estado.

Contados a partir da referência pública no Postman (V2.1) em novembro de 2026. As APIs Articles e Search estão descontinuadas e ficaram fora da contagem.

Abrir a referência completa da APIAbre num novo separador.
Quer a sua app dentro da Camping.care?

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 appA página completa da sua app, aberta a partir da App Store.
  • DashboardUm bloco no dashboard que a equipa vê quando inicia sessão.
  • ReservaUm bloco dentro da janela da reserva.
  • Separador da reservaUm separador inteiro na reserva, quando precisa de mais espaço.
  • ContactoUm bloco dentro da janela do hóspede.
  • Separador do contactoUm separador inteiro na ficha do hóspede.
  • Formulário de reserva onlineUm passo no motor de reservas, com o carrinho e o rascunho de preço a que pertence.
Widget → Camping.care
// 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}, '*');
Ler a documentação da App StoreAbre num novo separador.
Como é que o seu código inicia sessão?

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

    Para motores de reservas e sites

    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

    Para os seus próprios servidores

    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

    Para apps da App Store

    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

    Para páginas destinadas aos hóspedes

    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.

Chave secreta, a partir do seu servidor
curl "https://api.camping.care/v21/users/me" \  -H "Accept: application/json" \  -H "Authorization: Bearer {secret_key}"
Ler a documentação de autenticaçãoAbre num novo separador.
O que pode uma app ver?

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.
Como funcionam os direitos e os scopesAbre num novo separador.

Bom saber antes de começar

URLs de recursos previsíveis, verbos HTTP e códigos de estado normais.
REST e JSON
O limite de pedidos, com cabeçalhos X-Ratelimit em cada resposta.
120 chamadas por minuto
HMAC-SHA256, reenviados após 5 segundos, 30 segundos e 5 minutos.
Webhooks assinados
Cada chamada por HTTPS, cada data e hora em UTC.
HTTPS e UTC
DemoComeçar grátis