Bokningar och kundresan
Skapa, hämta och hantera bokningar genom API:et, inklusive det publika kassaflödet.
Arbeta med bokningar
Boknings-API:et täcker två arbetsflöden: operatörssidan (skapa, uppdatera och lista bokningar) och det publika kassaflödet för kundvända butiker.
Operatörsbokningar
Lista bokningar
bash
curl -X GET "https://api.fjellride.se/api/v1/bookings?limit=25" \
-H "x-api-key: fjr_din_api_nyckel"Bokningsstatusar
| Status | Beskrivning |
|---|---|
CONCEPT | Utkast — inte bekräftad |
PENDING_PAYMENT | Bekräftad men obetald |
RESERVED | Betald och bekräftad |
PICKED_UP | Alla varor hämtade |
RETURNED | Alla varor returnerade — klar |
CANCELLED | Avbokad |
Skapa en manuell bokning
bash
curl -X POST "https://api.fjellride.se/api/v1/bookings/manual" \
-H "x-api-key: fjr_din_api_nyckel" \
-H "Content-Type: application/json" \
-d '{
"startDate": "2026-07-10",
"endDate": "2026-07-12",
"fromLocationId": 1,
"toLocationId": 1,
"status": "RESERVED",
"products": [
{ "productId": 42, "quantity": 1 }
]
}'Publikt kassaflöde
Steg 1: Validera kundvagn
bash
curl -X POST "https://api.fjellride.se/api/v1/public/cart" \
-H "Content-Type: application/json" \
-H "x-organization-slug: din-org-slug" \
-d '{
"products": [{ "productId": 42, "quantity": 2 }],
"startDate": "2026-07-01",
"endDate": "2026-07-03",
"fromLocationId": 1,
"toLocationId": 1
}'Steg 2: Skapa kassa
bash
curl -X POST "https://api.fjellride.se/api/v1/public/checkout" \
-H "Content-Type: application/json" \
-H "x-organization-slug: din-org-slug" \
-d '{
"products": [{ "productId": 42, "quantity": 2 }],
"startDate": "2026-07-01",
"endDate": "2026-07-03",
"fromLocationId": 1,
"toLocationId": 1,
"email": "kund@example.com",
"successUrl": "https://din-butik.se/bokning/klar",
"cancelUrl": "https://din-butik.se/bokning/avbryt"
}'