Czy dostęp do API jest zawarty w każdym planie?

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

Czy istnieje specyfikacja OpenAPI?

Tak. Pełna dokumentacja OpenAPI jest dostępna na api.arecabooking.com, gdzie znajdziesz interaktywne Swagger UI umożliwiające przeglądanie i testowanie każdego endpointu.

Jak są zabezpieczone webhooki?

Każdy ładunek webhooka jest podpisywany sygnaturą HMAC-SHA256 przy użyciu unikalnego dla Twojego punktu końcowego sekretu. Zweryfikuj sygnaturę przed przetworzeniem 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, ograniczając się do zakresów uprawnień przypisanych do przekazanego im tokena.

Deweloperzy

Otwarta platforma hotelarska
dla deweloperów

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

Poznaj dokumentację API Porozmawiaj z naszym zespołem

Szybki start

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

Jeden token uwierzytelniający, jedno żądanie, przewidywalny JSON. Pobierz dostępność i ceny za typ pokoju dla dowolnego zakresu dat, a następnie utwórz rezerwację za pomocą jednego żądania POST do tego samego zasobu.

Zobacz wszystkie endpointy 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}/availability

Platforma

Trzy sposoby na rozwijanie Areca

Żądaj danych, kiedy ich potrzebujesz, otrzymuj powiadomienia natychmiast po ich zmianie lub przekazuj 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 tokenem bearer i przejrzystymi limitami zapytań. Pełna obsługa rezerwacji, zasobów, stawek, gości, rachunków i obsługi pokojowej.

Dokumentacja API

Webhooki w czasie rzeczywistym

Architektura oparta na zdarzeniach z ładunkami podpisanymi HMAC. Uruchamiaj przepływy pracy natychmiast po zdarzeniach takich jak booking.created, checkin.completed, payment.logged lub room.status_changed.

Zobacz ładunek

Natywny serwer MCP

Wbudowany serwer Model Context Protocol pozwala LLM i przepływom pracy AI przeglądać kontekst nieruchomości, zarządzać rezerwacjami oraz wykonywać działania z precyzyjnie określonymi zakresami uprawnień.

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-added

Panel Areca został zbudowany na tych samych endpointach, które wywołujesz. Jeśli funkcja istnieje w interfejsie użytkownika, jest dostępna także w API – z tymi samymi danymi, tą samą walidacją i taką samą szybkością.

Brak płatnych barier, brak uzależnienia od dostawcy

Dostęp do API nie jest dodatkiem dla przedsiębiorstw. Rezerwacje, dostępność, ceny, goście i rachunki są otwarte od pierwszego dnia, we wszystkich planach, więc Twoje dane zawsze należą do Ciebie.

Zdarzenia zamiast odpytywania

Webhooki przekazują każdą zmianę w momencie jej wystąpienia. Utrzymuj synchronizację inteligentnych zamków, aplikacji do komunikacji i narzędzi księgowych bez marnowania zapytań na pętlach odpytywania.

Stworzony dla agentów AI

Natwny serwer MCP umożliwia Claude, niestandardowym narzędziom LLM i wewnętrznym botom odczytywanie aktualnej dostępności, przeglądanie kart gości oraz przeprowadzanie zameldowań, wszystko w ramach udzielonych przez Ciebie uprawnień.

Webhooki

Przestań odpytywać. Zacznij reagować.

Subskrybuj interesujące Cię zdarzenia, a Areca dostarczy podpisany ładunek JSON na Twój endpoint w ciągu kilku sekund. Zweryfikuj sygnaturę HMAC, zareaguj na zdarzenie i utrzymuj pełną synchronizację wszystkich zewnętrznych systemów.

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. Podłącz Claude’a, własne narzędzia LLM lub wewnętrznego bota, a system będzie mógł analizować bieżące dane o nieruchomościach i podejmować realne działania, ograniczone dokładnie do 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 folio
Zakresy odczytu i zapisu przyznawane 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:

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

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 linii kodu, aby połączyć Areca z urządzeniami i narzędziami, których używa Twój obiekt.

Wygeneruj kod do drzwi w momencie zameldowania gościa i prześlij go za pomocą webhooka do mostków zamków Yale, Salto lub August. Automatycznie cofnij kod 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 urządzenia lobby, które wyszukują rezerwacje, zbierają dane gości i umożliwiają finalizację zameldowania 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" }),
});

Wysyłaj zmiany statusu rezerwacji do WhatsApp, bramek SMS Twilio lub swojej platformy obsługi gości, aby przekazywać właściwą wiadomość we właściwym 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}

Strumieniuj pozycje folio i dzienniki płatności do Xero, QuickBooks lub miejskich portali podatku turystycznego. Koniec z eksportowaniem 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

Poznaj dokumentację API już dziś lub powiedz nam, co tworzysz, a pomożemy Ci to wdrożyć

Poznaj dokumentację API Porozmawiaj z naszym zespołem

Oferta specjalna na otwarcie: zarejestruj się do 31 października 2026 i otrzymaj kupon 50%.

FAQ dla deweloperów

Tak. Areca jest oparta na API: sam panel zarządzania korzysta z publicznego REST API, więc rezerwacje, dostępność, ceny, goście, rachunki i prace porządkowe są dostępne dla Twoich integracji.

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