O acesso à API está incluído em todos os planos?

Sim. Não há níveis bloqueados ou complementos pagos de API. Todas as propriedades Areca podem usar a REST API, webhooks e o servidor MCP desde o primeiro dia.

Existe uma especificação OpenAPI?

Sim. A referência completa do OpenAPI está publicada em api.arecabooking.com, com uma interface Swagger UI interativa que você pode usar para explorar e testar cada endpoint.

Como os webhooks são protegidos?

Todo payload de webhook é assinado com uma assinatura HMAC-SHA256 usando um segredo exclusivo para o seu endpoint. Verifique a assinatura antes de processar o evento para garantir que ele veio da Areca.

O que é o servidor MCP Areca?

É um servidor Model Context Protocol que expõe o Areca para agentes de IA como o Claude. Os agentes podem consultar disponibilidade, ler folios e gerenciar reservas, limitados aos escopos de permissão do token que você fornecer.

Desenvolvedores

A plataforma de hospitalidade aberta
para desenvolvedores

Crie integrações personalizadas, automatize fluxos de trabalho da recepção e implemente agentes de IA com a REST API da Areca, webhooks em tempo real e servidor MCP nativo.

Explore a referência da API Fale com a nossa equipe

Início rápido

Disponibilidade de quartos ao vivo
em cinco linhas de código

Um token bearer, uma solicitação, JSON previsível. Consulte disponibilidade e tarifas por tipo de quarto para qualquer intervalo de datas e, em seguida, crie a reserva com um único POST para o mesmo recurso.

Veja todos os endpoints na referência OpenAPI

curl "https://api.arecabooking.com/properties/$PROPERTY_ID/availability?startDate=2026-10-01&days=7" \
  -H "Authorization: Bearer $ARECA_API_KEY"

GET /properties/{propertyId}/availability

A plataforma

Três maneiras de construir com o Areca

Solicite dados quando precisar, seja notificado assim que houver alterações ou entregue-os a um agente de IA. Todas as três opções compartilham as mesmas permissões e a mesma fonte de verdade.

API REST

Endpoints REST abertos com JSON previsível, autenticação por token bearer e limites de taxa transparentes. Cobertura completa de reservas, inventário, tarifas, hóspedes, faturas e limpeza.

Referência da API

Webhooks em tempo real

Arquitetura orientada a eventos com payloads assinados por HMAC. Acione fluxos de trabalho instantaneamente em eventos como booking.created, checkin.completed, payment.logged ou room.status_changed.

Ver um payload

Servidor MCP nativo

Um servidor integrado de Protocolo de Contexto de Modelo permite que LLMs e fluxos de trabalho de IA inspecionem o contexto das propriedades, gerenciem reservas e executem ações com escopos de permissão granulares.

Como funciona

Infraestrutura, não apenas software

A maioria dos fornecedores de PMS adiciona uma API a um produto fechado e cobra um valor extra por isso. O Areca foi projetado exatamente ao contrário.

API-primeiro, não API-adicionado

O painel Areca é construído exatamente sobre os mesmos endpoints que você utiliza. Se um recurso existe na interface, ele existe na API, com os mesmos dados, a mesma validação e a mesma velocidade.

Sem barreiras de pagamento, sem contratos de fidelidade

O acesso à API não é um recurso adicional para empresas. Reservas, inventário, tarifas, hóspedes e faturas estão disponíveis desde o primeiro dia, em todos os planos, para que seus dados sejam sempre seus.

Eventos em vez de polling

Webhooks enviam cada alteração no momento em que acontece. Mantenha fechaduras inteligentes, aplicativos de mensagens e ferramentas de contabilidade sempre sincronizados sem desperdiçar requisições em loops de polling.

Desenvolvido para agentes de IA

Um servidor MCP nativo permite que Claude, ferramentas LLM personalizadas e bots internos leiam a disponibilidade em tempo real, consultem fichas de hóspedes e realizem check-ins, tudo dentro das permissões que você conceder.

Webhooks

Pare de consultar. Comece a reagir.

Assine os eventos que são importantes para você e o Areca envia um payload JSON assinado para seu endpoint em segundos. Verifique a assinatura HMAC, aja conforme o evento e mantenha todos os sistemas externos perfeitamente sincronizados.

booking.created
booking.modified
booking.cancelled
checkin.completed
checkout.completed
payment.logged
room.status_changed

POST /webhooks/areca
X-Areca-Signature: sha256=9f2c4e...

{
  "type": "checkin.completed",
  "createdAt": "2026-10-01T14:02:11Z",
  "propertyId": "7c1e9a52-...",
  "data": {
    "bookingId": "b4d0f3e1-...",
    "room": "204",
    "checkOut": "2026-10-04"
  }
}

Servidor MCP

Dê à sua IA uma recepção

Areca fala o Model Context Protocol nativamente. Conecte o Claude, suas próprias ferramentas LLM ou um bot interno e ele poderá analisar dados de propriedades em tempo real e tomar ações reais, limitadas exatamente às permissões que você atribuir ao seu token.

Funciona com Claude e qualquer cliente compatível com MCP
Ferramentas para disponibilidade, reservas, hóspedes e faturas
Escopos de leitura e escrita concedidos por token, nunca mais

Quais quartos duplos estão disponíveis no próximo fim de semana e a que tarifa?

search_availability 142 ms

{ "from": "2026-10-09", "nights": 2, "occupancy": 2 }

Três quartos duplos estão disponíveis de sexta-feira, 9, até domingo, 11 de outubro:

201Duplo Deluxe€128 / noite
204Duplo Standard€112 / noite
305Duplo Vista Mar€146 / noite

Quer que eu reserve o quarto 305 para o seu hóspede?

availability:readbookings:writefolios:write

Casos de uso

O que você
vai construir a seguir?

Um webhook e algumas linhas de código são tudo o que você precisa para conectar o Areca ao hardware e às ferramentas que sua propriedade já utiliza.

Gere um código de porta no momento do check-in do hóspede e envie-o via webhook para as pontes de fechadura Yale, Salto ou August. Revogue-o automaticamente no checkout.

// Fires the moment the front desk checks a guest in
app.post("/webhooks/areca", async (req, res) => {
  const { type, data } = verifyArecaSignature(req);
  if (type === "checkin.completed") {
    const code = await salto.createAccessCode({
      room: data.room,
      validUntil: data.checkOut,
    });
    await sms.send(data.guest.phone, `Your door code: ${code}`);
  }
  res.sendStatus(200);
});

Crie aplicativos móveis personalizados ou hardware de lobby que consultam reservas, coletam dados dos hóspedes e realizam o check-in diretamente através da API Areca.

const api = `https://api.arecabooking.com/properties/${propertyId}`;
const headers = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };

// Guest scans the QR code from their confirmation email
const booking = await fetch(`${api}/bookings/${bookingId}`, { headers })
  .then((res) => res.json());

await fetch(`${api}/bookings/${bookingId}/status`, {
  method: "PATCH",
  headers,
  body: JSON.stringify({ status: "CHECKED_IN" }),
});

Envie alterações no status da reserva para o WhatsApp, gateways SMS do Twilio ou para a sua plataforma de experiência do hóspede para transmitir a mensagem certa no momento certo.

@app.post("/webhooks/areca")
def on_event(event: dict = Depends(verify_areca_signature)):
    if event["type"] == "booking.created":
        guest = event["data"]["guest"]
        twilio.messages.create(
            to=f"whatsapp:{guest['phone']}",
            from_="whatsapp:+14155238886",
            body=f"Hi {guest['firstName']}, your stay is confirmed!",
        )
    return {"ok": True}

Transmita itens de linha do folio e registros de pagamento diretamente para o Xero, QuickBooks ou portais municipais de taxa de turismo. Chega de exportações de CSV no fim do mês.

// Every payment recorded in Areca lands in Xero
if (event.type === "payment.logged") {
  const { amount, currency, method, bookingId } = event.data;

  await xero.payments.create({
    reference: `Areca ${bookingId}`,
    amount,
    currencyCode: currency,
    account: method === "CARD" ? "090" : "091",
  });
}

// Fires the moment the front desk checks a guest in
app.post("/webhooks/areca", async (req, res) => {
  const { type, data } = verifyArecaSignature(req);
  if (type === "checkin.completed") {
    const code = await salto.createAccessCode({
      room: data.room,
      validUntil: data.checkOut,
    });
    await sms.send(data.guest.phone, `Your door code: ${code}`);
  }
  res.sendStatus(200);
});

const api = `https://api.arecabooking.com/properties/${propertyId}`;
const headers = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };

// Guest scans the QR code from their confirmation email
const booking = await fetch(`${api}/bookings/${bookingId}`, { headers })
  .then((res) => res.json());

await fetch(`${api}/bookings/${bookingId}/status`, {
  method: "PATCH",
  headers,
  body: JSON.stringify({ status: "CHECKED_IN" }),
});

@app.post("/webhooks/areca")
def on_event(event: dict = Depends(verify_areca_signature)):
    if event["type"] == "booking.created":
        guest = event["data"]["guest"]
        twilio.messages.create(
            to=f"whatsapp:{guest['phone']}",
            from_="whatsapp:+14155238886",
            body=f"Hi {guest['firstName']}, your stay is confirmed!",
        )
    return {"ok": True}

// Every payment recorded in Areca lands in Xero
if (event.type === "payment.logged") {
  const { amount, currency, method, bookingId } = event.data;

  await xero.payments.create({
    reference: `Areca ${bookingId}`,
    amount,
    currencyCode: currency,
    account: method === "CARD" ? "090" : "091",
  });
}

Junte-se ao Areca

Comece a construir na Areca

Explore a referência da API hoje ou nos conte o que você está construindo e nós ajudaremos você a lançar.

Explore a referência da API Fale com a nossa equipe

Em breve! Inscreva-se na lista de espera para preços exclusivos de pré-lançamento.

Perguntas Frequentes para Desenvolvedores

Sim. O Areca é API-first: o próprio painel funciona com a REST API pública, portanto reservas, disponibilidade, tarifas, hóspedes, contas e governança estão todos disponíveis para suas integrações.

Disponibilidade de quartos ao vivo em cinco linhas de código