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ń.
POST /v1/office/gate-eventsWA 12345main-gateNie 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
allowalbodeny.Używa:
POST /v1/office/gate-eventsSprawdzajcie kartę dostępu
System kontroli dostępu pyta po identyfikatorze osoby w Rezu Office (
memberId, zwraca goGET /v1/office/rosterrazem ze służbowym e-mailem), który powiążecie z jej kartą.Używa:
POST /v1/office/gate-eventsPokażcie, kto ma dziś miejsce
System kadrowy albo intranet pobiera listę osób z miejscem na dany dzień.
Używa:
GET /v1/office/rosterLiczcie 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/bookingsReagujcie 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
https://neighbor-parking-backend.vercel.app/api1. 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:
curl https://neighbor-parking-backend.vercel.app/api/v1/office/me \
-H "Authorization: Bearer rz_live_YOUR_KEY"{
"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:
{"error":{"code":"api_key_invalid","message":"Missing or invalid API key"}}3. Kto ma miejsce danego dnia. Z zakresem read:roster:
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.
| Zakres | Co daje |
|---|---|
read:roster | kto ma miejsce danego dnia, z imieniem i nazwiskiem oraz służbowym e-mailem osoby; lista lokalizacji i miejsc |
read:bookings | rezerwacje w zakresie dat, lista lokalizacji i miejsc |
read:plates | numery rejestracyjne (RODO: osobny zakres, bez niego numery nigdy nie wychodzą) |
write:gate-events | zgłaszanie wjazdów i odpowiedź, czy wpuścić |
webhooks | rejestracja 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/bookingsobejmuje najwyżej 62 dni i zwraca do 1000 rezerwacji na stronę (domyślnie 500); kolejne strony przeznextCursor.- Zgłoszenie wjazdu przyjmuje
occurredAtz 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żka | Zakres | Opis |
|---|---|---|
GET /v1/office/me | dowolny | firma, nazwa i zakresy klucza, dzisiejsza data |
GET /v1/office/roster | read:roster | kto ma miejsce danego dnia: potwierdzone rezerwacje i stali posiadacze, którzy nie oddali dnia. Parametry date (domyślnie dziś) i locationId |
GET /v1/office/bookings | read:bookings | rezerwacje w każdym statusie od from do to, filtry status i locationId, strony przez limit i cursor |
GET /v1/office/spots | read:roster lub read:bookings | lokalizacje i miejsca: rodzaj (zwykłe, z ładowarką, dla osób z niepełnosprawnościami) i stały posiadacz |
POST /v1/office/gate-events | write:gate-events | zgłoszenie wjazdu, odpowiedź allow albo deny |
GET /v1/office/webhooks | webhooks | lista endpointów (bez sekretów) |
POST /v1/office/webhooks | webhooks | rejestracja endpointu; sekret pokazujemy tylko w tej odpowiedzi |
PATCH /v1/office/webhooks/{id} | webhooks | zmiana adresu, zdarzeń lub opisu, wyłączenie i ponowne włączenie |
DELETE /v1/office/webhooks/{id} | webhooks | usunięcie endpointu; oczekujące doręczenia dostają status failed |
GET /v1/office/webhooks/{id}/deliveries | webhooks | dziennik 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.
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" }'{
"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
}{
"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:
| reason | Decyzja | Znaczenie |
|---|---|---|
booking | allow | potwierdzona rezerwacja na ten dzień |
fixed_spot | allow | stałe miejsce, dzień nie został oddany |
no_booking | deny | osoba jest w Waszej firmie, ale tego dnia nie ma miejsca |
unknown_plate | deny | żadna osoba w Waszej firmie nie podała tego numeru |
unknown_member | deny | w Waszej firmie nie ma osoby o tym memberId |
member_inactive | deny | konto osoby nie jest aktywne albo jej dostęp wygasł |
- Nowe zdarzenie zwraca
201. Powtórka z tym samymIdempotency-Key(nagłówek albo poleidempotencyKey, do 128 znaków) zwraca200i pierwszą odpowiedź zreplayed: true, więc po zerwanym połączeniu możecie bezpiecznie ponowić zapytanie. - Ten sam
Idempotency-Keyz inną treścią zwraca409 idempotency_key_reused. - Numer rejestracyjny wraca w odpowiedzi (
plate) tylko do kluczy z zakresemread: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 odpowiada403 org_suspended. - Każde zgłoszenie wysyła też webhook
gate.entrydo 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).
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"] }'| Zdarzenie | Kiedy |
|---|---|
booking.created | nowa rezerwacja. data.booking.source: manual (pracownik sam), rhythm (stałe dni), lottery (losowanie), waitlist (kolejka), admin (administrator) albo team_lead (lider zespołu) |
booking.cancelled | anulowanie. 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.released | miejsce 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.entry | zgł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
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{
"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:
secret = whsec_test_vector_secret
t = 1793610000
body = {"id":"evt_test","type":"gate.entry"}
v1 = 85445fadc858b25c46b6da4dc0aa366b0499af38386a2a1a11cf76a6eaf3ee60import 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);
});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 "", 204Ponowienia
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 zincludePlates: true, co też wymagaread: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.
{
"error": {
"code": "api_key_scope_missing",
"message": "This API key does not have the required scope",
"details": {
"required": [
"write:gate-events"
],
"mode": "any"
}
}
}| Status | Kod | Znaczenie |
|---|---|---|
| 400 | validation_error | błędne zapytanie; details mówi, co poprawić (np. invalid_plate, occurred_at_out_of_range, range_too_long, invalid_cursor) |
| 400 | webhook_url_not_allowed | niedozwolony adres webhooka (details.reason) |
| 401 | api_key_invalid | brak klucza albo nieznany klucz |
| 401 | api_key_revoked | klucz został unieważniony |
| 403 | api_key_scope_missing | klucz nie ma wymaganego zakresu (details.required) |
| 403 | org_suspended | konto firmy jest zawieszone |
| 404 | feature_disabled | Rezu Office nie jest włączone |
| 404 | webhook_endpoint_not_found | nie ma takiego endpointu webhooka |
| 409 | idempotency_key_reused | ten sam Idempotency-Key z inną treścią |
| 409 | conflict | równoległe zgłoszenie z tym samym Idempotency-Key; ponówcie z tym samym kluczem |
| 409 | webhook_endpoint_limit_reached | firma ma już 10 endpointów webhooków |
| 429 | rate_limited | za dużo zapytań albo nieudanych prób uwierzytelnienia |
| 500 | internal_error | błąd po naszej stronie; ponówcie zapytanie, przy wjeździe z tym samym Idempotency-Key |
| 503 | maintenance_mode | przerwa 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.
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.