rezu

REZU OFFICE · API v1

API Rezu Office: dokumentacja dla działu IT

API Rezu Office łączy parking firmowy z systemami, które już macie. System obsługujący Wasz szlaban, kamerę ANPR albo kontrolę dostępu pyta Rezu Office, czy dana osoba ma dziś miejsce, i od razu dostaje odpowiedź. „Tak” dostają tylko osoby z miejscem na ten dzień.

Nie instalujemy u Was sprzętu ani oprogramowania. Po Waszej stronie potrzebny jest system, który umie wysłać zapytanie do API: sterownik szlabanu, system kontroli dostępu albo mały program łączący kamerę z bramą. Nie każdy sprzęt to potrafi, dlatego warto sprawdzić to z instalatorem.

Parking przestaje działać obok reszty firmy: te same dane o tym, kto ma dziś miejsce, i rezerwacje mogą trafić do systemu kadrowego, na tablicę „kto jest dziś w biurze” w intranecie albo do raportów.

Administrator Waszej firmy tworzy i unieważnia klucze API w panelu firmy Rezu Office i wybiera ich zakresy. Klucz pokazujemy tylko raz, przy utworzeniu. Gotowa integracja wykonana przez nas: na życzenie, wycena indywidualna.

Co możecie podłączyć

  • Pytajcie przed otwarciem szlabanu

    System obsługujący Waszą kamerę ANPR albo szlaban wysyła numer rejestracyjny i w odpowiedzi dostaje allow albo deny.

    Używa: POST /v1/office/gate-events

  • Sprawdzajcie kartę dostępu

    System kontroli dostępu pyta po identyfikatorze osoby w Rezu Office (memberId, zwraca go GET /v1/office/roster razem ze służbowym e-mailem), który powiążecie z jej kartą.

    Używa: POST /v1/office/gate-events

  • Pokażcie, kto ma dziś miejsce

    System kadrowy albo intranet pobiera listę osób z miejscem na dany dzień.

    Używa: GET /v1/office/roster

  • Liczcie obłożenie w raportach

    Rezerwacje w każdym statusie, do 62 dni w jednym zapytaniu, trafiają do Waszych raportów.

    Używa: GET /v1/office/bookings

  • Reagujcie na oddane miejsce

    Webhook przychodzi, gdy miejsce jest wolne na dany dzień, więc nie musicie pytać co chwilę.

    Używa: spot.released

Co dostajecie

  • Dokumentację po polsku i po angielsku oraz plik OpenAPI 3.1 do pobrania.
  • Podpisane webhooki o rezerwacjach, anulowaniach, oddanych miejscach i wjazdach, więc o tych zmianach nie musicie dowiadywać się, odpytując API.
  • Decyzję o wjeździe w odpowiedzi na to samo zapytanie.
  • Numery rejestracyjne tylko za osobnym uprawnieniem i podany czas przechowywania. Po 30 dniach zdarzenia wjazdu tracą osobę (pracownika, rezerwację, miejsce); po 90 dniach numer rejestracyjny; data, godzina, brama i decyzja zostają.
  • Limity podane w liczbach i opis, co robić, gdy API nie odpowiada.

Dla programistów

Dla programistów: HTTPS i JSON, klucz w nagłówku Authorization, osobne zakresy uprawnień, idempotentne zgłoszenia wjazdów i webhooki podpisane HMAC-SHA256. Pełna specyfikacja jest w pliku OpenAPI 3.1 na dole strony.

Szybki start

Adres bazowyhttps://neighbor-parking-backend.vercel.app/api

1. Utwórzcie klucz. Administrator Waszej firmy tworzy i unieważnia klucze API w panelu firmy Rezu Office i wybiera ich zakresy. Klucz pokazujemy tylko raz, przy utworzeniu. Klucz ma postać rz_live_ i 32 znaki. U nas zostaje tylko skrót SHA-256 i początek klucza do rozpoznania, więc przechowujcie klucz jak hasło: zgubionego nie odtworzymy, więc unieważnijcie go w panelu i utwórzcie nowy. Unieważnienie działa od razu.

2. Pierwsze zapytanie. Sprawdźcie, do jakiej firmy należy klucz i jakie ma zakresy:

Zapytaniebash
curl https://neighbor-parking-backend.vercel.app/api/v1/office/me \
  -H "Authorization: Bearer rz_live_YOUR_KEY"
Odpowiedź 200json
{
  "organization": {
    "id": "4c1f0a52-7d3e-4b8a-9f61-2a5d8e0c3b17",
    "slug": "acme",
    "name": "ACME"
  },
  "apiKey": {
    "id": "b7e2d9c4-1a6f-4e3b-8d05-6c9a2f1e7b40",
    "name": "Gate bridge",
    "prefix": "rz_live_Ab3dE9xQ",
    "scopes": [
      "read:roster",
      "write:gate-events"
    ]
  },
  "today": "2026-11-14"
}

Bez klucza albo z błędnym kluczem dostaniecie 401:

Odpowiedź 401json
{"error":{"code":"api_key_invalid","message":"Missing or invalid API key"}}

3. Kto ma miejsce danego dnia. Z zakresem read:roster:

Zapytaniebash
curl "https://neighbor-parking-backend.vercel.app/api/v1/office/roster?date=2026-11-16" \
  -H "Authorization: Bearer rz_live_YOUR_KEY"

Uwierzytelnianie i zakresy

Każde wywołanie wysyła klucz w nagłówku Authorization: Bearer rz_live_.... Klucz należy do jednej firmy i widzi tylko jej dane. Zakresy wybieracie przy tworzeniu klucza; jeden klucz może mieć kilka.

ZakresCo daje
read:rosterkto ma miejsce danego dnia, z imieniem i nazwiskiem oraz służbowym e-mailem osoby; lista lokalizacji i miejsc
read:bookingsrezerwacje w zakresie dat, lista lokalizacji i miejsc
read:platesnumery rejestracyjne (RODO: osobny zakres, bez niego numery nigdy nie wychodzą)
write:gate-eventszgłaszanie wjazdów i odpowiedź, czy wpuścić
webhooksrejestracja webhooków i zarządzanie nimi tym kluczem

Brak wymaganego zakresu kończy się odpowiedzią 403 api_key_scope_missing, a w details.required są brakujące zakresy. Każde utworzenie i unieważnienie klucza trafia do dziennika audytu.

Limity

  • 120 zapytań na minutę na klucz, wszystkie endpointy razem. Po przekroczeniu: 429 rate_limited.
  • Po 30 nieudanych próbach uwierzytelnienia z jednego adresu IP w ciągu 10 minut odpowiadamy 429.
  • Najwyżej 20 aktywnych kluczy i 10 endpointów webhooków na firmę.
  • GET /v1/office/bookings obejmuje najwyżej 62 dni i zwraca do 1000 rezerwacji na stronę (domyślnie 500); kolejne strony przez nextCursor.
  • Zgłoszenie wjazdu przyjmuje occurredAt z ostatnich 24 godzin (domyślnie: teraz).

Endpointy

Ścieżki są względne do adresu bazowego. Daty są w formacie RRRR-MM-DD, domyślna strefa czasowa to Europe/Warsaw.

Metoda i ścieżkaZakresOpis
GET /v1/office/medowolnyfirma, nazwa i zakresy klucza, dzisiejsza data
GET /v1/office/rosterread:rosterkto ma miejsce danego dnia: potwierdzone rezerwacje i stali posiadacze, którzy nie oddali dnia. Parametry date (domyślnie dziś) i locationId
GET /v1/office/bookingsread:bookingsrezerwacje w każdym statusie od from do to, filtry status i locationId, strony przez limit i cursor
GET /v1/office/spotsread:roster lub read:bookingslokalizacje i miejsca: rodzaj (zwykłe, z ładowarką, dla osób z niepełnosprawnościami) i stały posiadacz
POST /v1/office/gate-eventswrite:gate-eventszgłoszenie wjazdu, odpowiedź allow albo deny
GET /v1/office/webhookswebhookslista endpointów (bez sekretów)
POST /v1/office/webhookswebhooksrejestracja endpointu; sekret pokazujemy tylko w tej odpowiedzi
PATCH /v1/office/webhooks/{id}webhookszmiana adresu, zdarzeń lub opisu, wyłączenie i ponowne włączenie
DELETE /v1/office/webhooks/{id}webhooksusunięcie endpointu; oczekujące doręczenia dostają status failed
GET /v1/office/webhooks/{id}/deliverieswebhooksdziennik doręczeń, najnowsze najpierw

Wjazd: wpuścić czy nie?

Jak to działa: pyta zawsze Wasz system (sterownik szlabanu, system kontroli dostępu albo program obsługujący kamerę ANPR) i wysyła numer rejestracyjny albo identyfikator osoby. Rezu Office sprawdza w chwili zapytania, czy ta osoba ma na ten dzień potwierdzoną rezerwację albo stałe miejsce, którego nie oddała, zapisuje zdarzenie i w odpowiedzi na to samo zapytanie odsyła decyzję: allow albo deny. Szlaban otwiera albo zostawia zamknięty Wasz system.

Zapytaniebash
curl -X POST https://neighbor-parking-backend.vercel.app/api/v1/office/gate-events \
  -H "Authorization: Bearer rz_live_YOUR_KEY" \
  -H "Idempotency-Key: cam1-000123" \
  -H "Content-Type: application/json" \
  -d '{ "gateId": "main-gate", "plate": "WA 12345", "occurredAt": "2026-11-16T08:58:11+01:00" }'
Odpowiedź 201: wpuścićjson
{
  "gateEventId": "e5a1c3d7-2b4f-4a69-8c10-9d7e6f5a4b32",
  "gateId": "main-gate",
  "occurredAt": "2026-11-16T07:58:11.000Z",
  "date": "2026-11-16",
  "decision": "allow",
  "hasValidBooking": true,
  "reason": "booking",
  "member": {
    "id": "0d9c8b7a-6e5f-4d3c-b2a1-908f7e6d5c4b"
  },
  "booking": {
    "id": "7f6e5d4c-3b2a-4190-8e7d-6c5b4a392817",
    "date": "2026-11-16",
    "spotId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c6d"
  },
  "spot": {
    "id": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c6d",
    "label": "B-07",
    "locationId": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9"
  },
  "replayed": false
}
Odpowiedź 201: nie wpuszczaćjson
{
  "gateEventId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
  "gateId": "main-gate",
  "occurredAt": "2026-11-16T08:02:40.000Z",
  "date": "2026-11-16",
  "decision": "deny",
  "hasValidBooking": false,
  "reason": "unknown_plate",
  "member": null,
  "booking": null,
  "spot": null,
  "replayed": false
}

Zamiast plate możecie wysłać memberId. Numer może mieć dowolny zapis: zamieniamy go na wielkie litery i usuwamy spacje, myślniki i kropki. Pole reason mówi, skąd decyzja:

reasonDecyzjaZnaczenie
bookingallowpotwierdzona rezerwacja na ten dzień
fixed_spotallowstałe miejsce, dzień nie został oddany
no_bookingdenyosoba jest w Waszej firmie, ale tego dnia nie ma miejsca
unknown_platedenyżadna osoba w Waszej firmie nie podała tego numeru
unknown_memberdenyw Waszej firmie nie ma osoby o tym memberId
member_inactivedenykonto osoby nie jest aktywne albo jej dostęp wygasł
  • Nowe zdarzenie zwraca 201. Powtórka z tym samym Idempotency-Key (nagłówek albo pole idempotencyKey, do 128 znaków) zwraca 200 i pierwszą odpowiedź z replayed: true, więc po zerwanym połączeniu możecie bezpiecznie ponowić zapytanie.
  • Ten sam Idempotency-Key z inną treścią zwraca 409 idempotency_key_reused.
  • Numer rejestracyjny wraca w odpowiedzi (plate) tylko do kluczy z zakresem read:plates.
  • Wpuszczony wjazd z rezerwacją na dziś liczy się jako potwierdzenie przyjazdu, więc gdy firma wymaga potwierdzania, to miejsce nie wróci do puli za brak potwierdzenia, jeśli wjazd nastąpi przed godziną oddania niepotwierdzonych miejsc.
  • Gdy garaż firmy jest wstrzymany po bezpłatnym miesiącu, nikt nie ma w nim miejsca i odpowiedź to deny; gdy konto firmy jest zawieszone, API odpowiada 403 org_suspended.
  • Każde zgłoszenie wysyła też webhook gate.entry do endpointów, które go subskrybują.

Gdy API nie odpowiada

Przy odpowiedzi 5xx albo gdy odpowiedź nie przyjdzie na czas, wpuszczajcie ludzi tak jak dziś, kartą albo pilotem, i ponówcie zapytanie z tym samym Idempotency-Key. Nigdy nie traktujcie braku odpowiedzi jak deny.

Webhooki

Webhooki to powiadomienia, które Rezu Office wysyła na Wasz serwer, gdy coś się zmieni, więc nie musicie co chwilę pytać API.

Rejestracja: POST /v1/office/webhooks z adresem url i listą eventTypes. Sekret whsec_... pokazujemy tylko raz, w odpowiedzi na rejestrację. Adres musi używać https, portu 443 albo 8443 i wskazywać adres publiczny. Adresy prywatne, loopback i link-local odrzucamy przy rejestracji i przy każdym doręczeniu (sprawdzamy DNS).

Rejestracjabash
curl -X POST https://neighbor-parking-backend.vercel.app/api/v1/office/webhooks \
  -H "Authorization: Bearer rz_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/rezu", "eventTypes": ["booking.created", "booking.cancelled", "spot.released", "gate.entry"] }'
ZdarzenieKiedy
booking.creatednowa rezerwacja. data.booking.source: manual (pracownik sam), rhythm (stałe dni), lottery (losowanie), waitlist (kolejka), admin (administrator) albo team_lead (lider zespołu)
booking.cancelledanulowanie. data.reason: member (pracownik sam), admin, team_lead, member_removed (osoba usunięta z firmy), member_suspended (dostęp wstrzymany), member_inactive (dostęp wygasł), rhythm_release (stałe dni oddały rezerwację), no_show (firma wymaga potwierdzenia przyjazdu, a do godziny oddania niepotwierdzonych miejsc go nie było), member_not_coming (pracownik kliknął „Nie przyjadę”), member_away (pracownik zgłosił nieobecność tego dnia), member_not_parking (pracownik zaznaczył, że nie parkuje), org_paused (garaż firmy wstrzymany) albo org_terminated (umowa z firmą zakończona)
spot.releasedmiejsce wolne na dany dzień. data.reason: holder_gave_away (stały posiadacz oddał dzień), holder_away (stały posiadacz zgłosił nieobecność), booking_released, release_time (o godzinie oddania niepotwierdzonych miejsc, domyślnie 9:30, oddanego dnia nadal nikt nie zajął), no_show (z bookingId) albo member_not_coming
gate.entryzgłoszony wjazd wraz z decyzją. data.source: api (zgłosił Wasz system) albo app (wjazd odnotowany przez aplikację Rezu Office, tylko przy integracji bramy uzgodnionej z nami; zawsze allow, bez numeru rejestracyjnego)

Nowe wartości reason i source mogą się pojawić; nieznaną traktujcie jak zwykłe anulowanie albo oddanie miejsca.

Treść i nagłówki

Nagłówkihttp
POST /rezu HTTP/1.1
Content-Type: application/json
User-Agent: Rezu-Webhooks/1
Rezu-Signature: t=1794815892,v1=<hex HMAC-SHA256 of "1794815892." + raw body>
Rezu-Event-Id: evt_3f9a1c0b7d2e4a6f8b5c9d1e2f3a4b5c
Rezu-Event-Type: gate.entry
Rezu-Delivery-Id: 8d7c6b5a-4f3e-4d2c-9b1a-0f9e8d7c6b5a
Rezu-Delivery-Attempt: 1
Treść (gate.entry)json
{
  "id": "evt_3f9a1c0b7d2e4a6f8b5c9d1e2f3a4b5c",
  "type": "gate.entry",
  "apiVersion": "v1",
  "createdAt": "2026-11-16T07:58:12.204Z",
  "organization": {
    "id": "4c1f0a52-7d3e-4b8a-9f61-2a5d8e0c3b17",
    "slug": "acme"
  },
  "data": {
    "gateEventId": "e5a1c3d7-2b4f-4a69-8c10-9d7e6f5a4b32",
    "gateId": "main-gate",
    "source": "api",
    "occurredAt": "2026-11-16T07:58:11.000Z",
    "date": "2026-11-16",
    "decision": "allow",
    "reason": "booking",
    "memberId": "0d9c8b7a-6e5f-4d3c-b2a1-908f7e6d5c4b",
    "bookingId": "7f6e5d4c-3b2a-4190-8e7d-6c5b4a392817",
    "spotId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c6d"
  }
}

Każde zdarzenie ma stałe id (evt_..., także w nagłówku Rezu-Event-Id). Doręczamy je co najmniej raz i bez gwarancji kolejności, więc deduplikujcie po id.

Podpis

Nagłówek Rezu-Signature: t=<unix>,v1=<hex>, gdzie v1 = HMAC-SHA256(sekret, "<t>.<surowe body>"). Liczcie podpis z surowego body, zanim je sparsujecie, porównujcie w stałym czasie i odrzucajcie wiadomości z t starszym niż 5 minut. Sprawdźcie swoją implementację na tym przykładzie:

Wektor testowytext
secret = whsec_test_vector_secret
t      = 1793610000
body   = {"id":"evt_test","type":"gate.entry"}
v1     = 85445fadc858b25c46b6da4dc0aa366b0499af38386a2a1a11cf76a6eaf3ee60
Node.js (Express)js
import crypto from "node:crypto";
import express from "express";

const SECRET = process.env.REZU_WEBHOOK_SECRET; // whsec_...

function verifyRezuSignature(header, rawBody, secret, nowSeconds = Date.now() / 1000) {
  const parts = Object.fromEntries(
    String(header ?? "").split(",").map((p) => p.trim().split("=")).filter((kv) => kv.length === 2)
  );
  const t = Number(parts.t);
  if (!Number.isInteger(t) || Math.abs(nowSeconds - t) > 300) return false;
  if (!/^[0-9a-f]{64}$/i.test(parts.v1 ?? "")) return false;
  if (!Buffer.isBuffer(rawBody)) return false;
  const signed = Buffer.concat([Buffer.from(`${t}.`, "utf8"), rawBody]);
  const expected = crypto.createHmac("sha256", secret).update(signed).digest();
  return crypto.timingSafeEqual(Buffer.from(parts.v1, "hex"), expected);
}

const app = express();

app.post("/rezu", express.raw({ type: "application/json" }), (req, res) => {
  // express.raw leaves req.body as {} when the content type does not match: no raw bytes, nothing to verify.
  if (!Buffer.isBuffer(req.body)) return res.sendStatus(400);
  if (!verifyRezuSignature(req.get("Rezu-Signature"), req.body, SECRET)) return res.sendStatus(400);
  const event = JSON.parse(req.body.toString("utf8"));
  // dedupe on event.id, then handle event.type
  res.sendStatus(204);
});
Python (Flask)python
import hashlib, hmac, json, os, time
from flask import Flask, request, abort

SECRET = os.environ["REZU_WEBHOOK_SECRET"].encode()  # whsec_...
app = Flask(__name__)

def verify_rezu_signature(header, raw, secret, now=None):
    try:
        parts = dict(p.strip().split("=", 1) for p in (header or "").split(","))
        t = int(parts["t"])
        given = bytes.fromhex(parts["v1"])
    except (KeyError, ValueError):
        return False
    if abs((time.time() if now is None else now) - t) > 300:
        return False
    expected = hmac.new(secret, f"{t}.".encode() + raw, hashlib.sha256).digest()
    return hmac.compare_digest(expected, given)

@app.post("/rezu")
def rezu():
    raw = request.get_data()  # raw bytes, before parsing
    if not verify_rezu_signature(request.headers.get("Rezu-Signature"), raw, SECRET):
        abort(400)
    event = json.loads(raw)
    # dedupe on event["id"], then handle event["type"]
    return "", 204

Ponowienia

Każda odpowiedź 2xx w ciągu 10 sekund oznacza doręczenie. Wszystko inne, także przekierowania i przekroczenie czasu, ponawiamy najwcześniej po 1 min, 5 min, 30 min, 2 h, 6 h, 12 h i 24 h od poprzedniej próby. Po 8 próbach doręczenie dostaje status failed. Po 15 kolejnych nieudanych próbach endpoint jest wyłączany (disabledReason: "too_many_failures"); włączycie go z powrotem przez PATCH z { "status": "active" }. Po ponownym włączeniu endpointu nieudane doręczenia nie są wysyłane ponownie; sprawdźcie dziennik: GET /v1/office/webhooks/{id}/deliveries. Zdarzenia przechowujemy 30 dni.

Numery rejestracyjne i prywatność

  • Numery rejestracyjne podaje sam pracownik w aplikacji, najwyżej 3. Zapisujemy je wielkimi literami, bez spacji.
  • Numery wychodzą z API tylko do kluczy z zakresem read:plates, a w webhookach tylko do endpointów z includePlates: true, co też wymaga read:plates.
  • Gdy pracownik odchodzi z firmy, usuwamy jego numery z listy firmy; w zdarzeniach wjazdu zostają najdłużej 90 dni.
  • Po 30 dniach zdarzenia wjazdu tracą osobę (pracownika, rezerwację, miejsce); po 90 dniach numer rejestracyjny; data, godzina, brama i decyzja zostają.
  • W Rezu Office dane o przyjeździe służą do przydziału miejsc i nie zbieramy przy nich lokalizacji. Godziny potwierdzeń w aplikacji usuwamy po 30 dniach. Wjazdy zgłoszone przez Wasz system zapisujemy też u nas, na tych samych zasadach; to, co odbierzecie przez API i webhooki, przechowujecie już Wy.
  • API nie czyta prywatnych danych z Rezu: pojazdów z konta, numerów telefonu ani rezerwacji Rezu Daily.

Błędy

Każdy błąd ma ten sam kształt: error.code do obsługi w kodzie, error.message dla człowieka i opcjonalne error.details. Przy validation_error pole details to obiekt z reason albo lista błędów poszczególnych pól.

Odpowiedź 403json
{
  "error": {
    "code": "api_key_scope_missing",
    "message": "This API key does not have the required scope",
    "details": {
      "required": [
        "write:gate-events"
      ],
      "mode": "any"
    }
  }
}
StatusKodZnaczenie
400validation_errorbłędne zapytanie; details mówi, co poprawić (np. invalid_plate, occurred_at_out_of_range, range_too_long, invalid_cursor)
400webhook_url_not_allowedniedozwolony adres webhooka (details.reason)
401api_key_invalidbrak klucza albo nieznany klucz
401api_key_revokedklucz został unieważniony
403api_key_scope_missingklucz nie ma wymaganego zakresu (details.required)
403org_suspendedkonto firmy jest zawieszone
404feature_disabledRezu Office nie jest włączone
404webhook_endpoint_not_foundnie ma takiego endpointu webhooka
409idempotency_key_reusedten sam Idempotency-Key z inną treścią
409conflictrównoległe zgłoszenie z tym samym Idempotency-Key; ponówcie z tym samym kluczem
409webhook_endpoint_limit_reachedfirma ma już 10 endpointów webhooków
429rate_limitedza dużo zapytań albo nieudanych prób uwierzytelnienia
500internal_errorbłąd po naszej stronie; ponówcie zapytanie, przy wjeździe z tym samym Idempotency-Key
503maintenance_modeprzerwa techniczna; postępujcie jak przy braku odpowiedzi

Specyfikacja OpenAPI

Pełna specyfikacja maszynowa: ścieżki, parametry, schematy odpowiedzi, kody błędów i webhooki. Wczytacie ją do każdego narzędzia, które obsługuje OpenAPI 3.1.

Pobierz plik OpenAPI (JSON)OpenAPI 3.1 · rezu-office-v1.json

Pytania o API: kontakt@getrezu.pl. Jak działa sam Rezu Office: Rezu Office dla firm.

Pytania

Czy Rezu Office ma otwarte API?

Tak. API Rezu Office jest opisane na tej stronie po polsku i po angielsku, a pełna specyfikacja jest w pliku OpenAPI 3.1 do pobrania. Klucze API administrator tworzy w panelu firmy.

Co możemy podłączyć?

System, który umie wysłać zapytanie do API: sterownik szlabanu, system kontroli dostępu albo mały program łączący kamerę ANPR z bramą, a także system kadrowy, intranet albo narzędzie do raportów. Taki system pyta, kto ma miejsce, pobiera rezerwacje i dostaje webhooki o zmianach.

Czy coś u nas instalujecie?

Nie instalujemy u Was sprzętu ani oprogramowania. Po Waszej stronie potrzebny jest system, który umie wysłać zapytanie do API: sterownik szlabanu, system kontroli dostępu albo mały program łączący kamerę z bramą. Nie każdy sprzęt to potrafi, dlatego warto sprawdzić to z instalatorem. Gotowa integracja wykonana przez nas: na życzenie, wycena indywidualna.

Czy nasz szlaban albo kamera to obsłuży?

To zależy od tego, co macie. System kontroli dostępu albo sterownik szlabanu, który da się zaprogramować, trzeba skonfigurować albo zaprogramować tak, żeby pytał API. Kamera, która odczytuje tylko numery, potrzebuje po Waszej stronie małego programu: przekaże on numer do API i na podstawie odpowiedzi da sygnał bramie. Szlaban sterowany tylko pilotem, bez połączenia z siecią, wymaga dołożenia sterownika. Bez żadnej integracji ludzie wjeżdżają jak dziś, kartą albo pilotem, a Rezu Office tylko przydziela miejsca.

Czy Rezu Office otwiera bramę?

Przez API nie. Przez API Rezu Office tylko odpowiada, czy dana osoba ma dziś miejsce; szlaban otwiera Wasz system.

Jak dostać klucz API?

Administrator Waszej firmy tworzy i unieważnia klucze API w panelu firmy Rezu Office i wybiera ich zakresy. Klucz pokazujemy tylko raz, przy utworzeniu.

Co z numerami rejestracyjnymi i RODO?

Numery podaje sam pracownik w aplikacji, a z API wychodzą tylko do kluczy z osobnym zakresem read:plates. Po 30 dniach zdarzenia wjazdu tracą osobę (pracownika, rezerwację, miejsce); po 90 dniach numer rejestracyjny; data, godzina, brama i decyzja zostają. Wjazdy zgłoszone przez Wasz system zapisujemy też u nas, na tych samych zasadach; to, co odbierzecie przez API i webhooki, przechowujecie już Wy.

Co, gdy API nie odpowiada?

Wpuszczajcie ludzi tak jak dziś, kartą albo pilotem, i ponówcie zapytanie z tym samym Idempotency-Key. Brak odpowiedzi nie oznacza deny.

Najpierw garaż, potem integracja.

Rezu Office działa bez żadnej integracji: ludzie rezerwują miejsca w aplikacji i wjeżdżają jak dziś, kartą albo pilotem. API podłączycie wtedy, gdy będziecie gotowi.