Guider & hjälp — fjellride.se

Tillbaka till Integrationer & API

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

StatusBeskrivning
CONCEPTUtkast — inte bekräftad
PENDING_PAYMENTBekräftad men obetald
RESERVEDBetald och bekräftad
PICKED_UPAlla varor hämtade
RETURNEDAlla varor returnerade — klar
CANCELLEDAvbokad

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