Czy dostęp do API jest uwzględniony we wszystkich planach?

Tak. Nie ma zablokowanych planów ani płatnych dodatków do API. Każda nieruchomość w Areca może korzystać z REST API, webhooks i serwera MCP od pierwszego dnia.

Czy istnieje specyfikacja OpenAPI?

Tak. Pełna dokumentacja OpenAPI jest opublikowana na api.arecabooking.com, a interaktywny interfejs Swagger UI pozwala na eksplorowanie i testowanie każdego endpointu.

Jak zabezpieczone są webhooki?

Każda ładowność webhooka jest podpisana sygnaturą HMAC-SHA256 przy użyciu sekretu unikalnego dla Twojego punktu końcowego. Zweryfikuj sygnaturę przed przetwarzaniem zdarzenia, aby upewnić się, że pochodzi ono od Areca.

Czym jest serwer Areca MCP?

Jest to serwer Model Context Protocol, który udostępnia Areca agentom AI, takim jak Claude. Agenci mogą sprawdzać dostępność, odczytywać folia oraz zarządzać rezerwacjami, w ramach zakresu uprawnień przypisanych do przekazanego im tokena.

Deweloperzy

Otwarta platforma hotelarska
dla deweloperów

Twórz niestandardowe integracje, automatyzuj przepływy pracy recepcji i wdrażaj agentów AI dzięki REST API Areca, webhookom w czasie rzeczywistym i natywnemu serwerowi MCP.

Przeglądaj dokumentację API Porozmawiaj z naszym zespołem

Szybki start

Dostępność pokoi na żywo
w pięciu linijkach kodu

Jeden token dostępu, jedno żądanie, przewidywalny JSON. Pobierz dostępność i ceny według typu pokoju dla dowolnego zakresu dat, a następnie utwórz rezerwację za pomocą jednego POST na ten sam zasób.

Zobacz każdy endpoint w dokumentacji 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}/dostępność

Platforma

Trzy sposoby na rozwijanie Areca

Żądaj danych, kiedy ich potrzebujesz, otrzymuj powiadomienia natychmiast po ich zmianie lub przekaż je agentowi AI. Wszystkie trzy korzystają z tych samych uprawnień i tego samego źródła prawdy.

REST API

Otwarte punkty końcowe REST z przewidywalnym JSON, uwierzytelnianiem przy użyciu tokena typu bearer i przejrzystymi limitami zapytań. Pełne pokrycie rezerwacji, zasobów, stawek, gości, rachunków i obsługi pokoi.

Dokumentacja API

Webhooki w czasie rzeczywistym

Architektura oparta na zdarzeniach z ładunkami podpisanymi HMAC. Natychmiastowe uruchamianie workflow po zdarzeniach takich jak booking.created, checkin.completed, payment.logged lub room.status_changed.

Zobacz ładunek

Natywny serwer MCP

Wbudowany serwer Model Context Protocol umożliwia LLM oraz procesom AI analizowanie kontekstu obiektu, zarządzanie rezerwacjami i wykonywanie działań z precyzyjnie określonymi uprawnieniami.

Jak to działa

Infrastruktura, nie tylko oprogramowanie

Większość dostawców PMS dołącza API do zamkniętego produktu i pobiera za to dodatkową opłatę. Areca została zaprojektowana odwrotnie.

API-first, nie API-dodane

Panel sterowania Areca jest oparty na tych samych punktach końcowych, które wywołujesz. Jeśli funkcja istnieje w interfejsie użytkownika, istnieje również w API, z tymi samymi danymi, tą samą walidacją i tą samą szybkością.

Brak ukrytych opłat, brak zobowiązań

Dostęp do API nie jest dodatkiem dla przedsiębiorstw. Rezerwacje, dostępność, ceny, goście i folia są otwarte od pierwszego dnia, w każdym planie, więc Twoje dane zawsze pozostają Twoje.

Zdarzenia zamiast odpytywania

Webhooks natychmiast przekazują każdą zmianę w chwili, gdy się pojawi. Utrzymuj synchronizację inteligentnych zamków, aplikacji do komunikacji i narzędzi księgowych bez obciążania zapytań pętlami odpytywania.

Stworzone dla agentów AI

Natywny serwer MCP umożliwia Claude, niestandardowym narzędziom LLM oraz wewnętrznym botom odczytywanie dostępności na żywo, przeglądanie profili gości i przeprowadzanie zameldowań, zgodnie z udzielonymi przez Ciebie uprawnieniami.

Webhooki

Przestań odpytywać. Zacznij reagować.

Subskrybuj interesujące Cię zdarzenia, a Areca dostarczy podpisany ładunek JSON do Twojego punktu końcowego w ciągu kilku sekund. Zweryfikuj podpis HMAC, zareaguj na zdarzenie i utrzymuj każdy zewnętrzny system w idealnej synchronizacji.

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"
  }
}

Serwer MCP

Daj swoim agentom AI recepcję

Areca natywnie obsługuje Model Context Protocol. Połącz Claude’a, własne narzędzia LLM lub wewnętrznego bota, a system będzie mógł analizować bieżące dane obiektu i podejmować rzeczywiste działania, ściśle w zakresie uprawnień przypisanych do jego tokena.

Działa z Claude i każdym klientem zgodnym z MCP
Narzędzia do dostępności, rezerwacji, gości i rachunków
Zakresy odczytu i zapisu przyznane na token, nigdy więcej

Które pokoje dwuosobowe są wolne w następny weekend i w jakiej cenie?

search_availability 142 ms

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

Trzy pokoje dwuosobowe są wolne od piątku 9 do niedzieli 11 października

201Dwuosobowy Deluxe€128 / noc
204Pokój Dwuosobowy Standardowy€112 / noc
305Pokój Dwuosobowy z Widokiem na Morze€146 / noc

Czy chcesz, abym zarezerwował pokój 305 dla Twojego gościa?

availability:readbookings:writefolios:write

Przypadki użycia

Co zbudujesz
następnie?

Wystarczy webhook i kilka linijek kodu, aby połączyć Areca z urządzeniami i narzędziami, z których już korzysta Twój obiekt.

Wygeneruj kod do drzwi w momencie zameldowania gościa i prześlij go za pomocą webhooka do mostków Yale, Salto lub August. Automatycznie unieważnij go przy wymeldowaniu.

// 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);
});

Twórz dedykowane aplikacje mobilne lub sprzęt do lobby, które wyszukują rezerwacje, zbierają dane gości i realizują zameldowanie bezpośrednio przez Areca API.

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" }),
});

Przesyłaj zmiany statusu rezerwacji do WhatsApp, bramek SMS Twilio lub platformy obsługi gości, aby wysłać właściwą wiadomość w odpowiednim momencie.

@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}

Przesyłaj pozycje folio i rejestry płatności bezpośrednio do Xero, QuickBooks lub miejskich portali podatku turystycznego. Koniec z eksportem plików CSV na koniec miesiąca.

// 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",
  });
}

Dołącz do Areca

Zacznij budować na Areca

Zapoznaj się z dokumentacją API już dziś lub powiedz nam, co tworzysz, a pomożemy Ci to wdrożyć.

Przeglądaj dokumentację API Porozmawiaj z naszym zespołem

Już wkrótce! Dołącz do listy oczekujących i skorzystaj z ekskluzyjnej oferty cenowej dla wcześniejszych zapisów.

FAQ dla deweloperów

Tak. Areca jest rozwiązaniem API-first: sam panel zarządzania działa na publicznym REST API, więc rezerwacje, dostępność, ceny, goście, folia i housekeeping są dostępne dla Twoich integracji.

Dostępność pokoi na żywo w pięciu linijkach kodu