# VoordeMensen Ticketservice - Volledige Documentatie
> Ticketplatform voor theaters, concertzalen en evenementen

## Over deze ticketshop
Dit is de ticketshop voor **tickets-staging**. 
VoordeMensen is een white-label ticketplatform voor theaters, concertzalen en festivals.

## Tickets bestellen (handmatig)

### Stap 1: Evenement kiezen
- Bekijk het overzicht op de homepage
- Klik op een evenement voor details

### Stap 2: Tickets selecteren
- Kies kaartsoort (regulier, korting, CJP, etc.)
- Selecteer aantal tickets
- Bij zaalvoorstellingen: kies stoelen op plattegrond

### Stap 3: Gegevens invullen
- E-mailadres (verplicht, voor ticketlevering)
- Voornaam en achternaam

### Stap 4: Betalen
- iDEAL, Bancontact, Creditcard, PayPal, etc.
- Na betaling: tickets per e-mail als PDF met QR-code

---

## API Documentatie

### OpenAPI Specificatie
https://tickets-staging.voordemensen.nl/openapi.yaml

### Base URL
https://api.voordemensen.nl/v1/tickets-staging/

### Publieke endpoints (geen authenticatie)

#### Evenementen
```
GET https://api.voordemensen.nl/v1/tickets-staging/events
GET https://api.voordemensen.nl/v1/tickets-staging/events/{id}
GET https://api.voordemensen.nl/v1/tickets-staging/events/{id}/avail
```

#### Kaartsoorten/tickettypes
```
GET https://api.voordemensen.nl/v1/tickets-staging/tickettypes/{event_id}
GET https://api.voordemensen.nl/v1/tickets-staging/discounts/{event_id}
```

#### Betaalmethodes
```
GET https://api.voordemensen.nl/v1/tickets-staging/paymentmethods
```

#### Locaties en types
```
GET https://api.voordemensen.nl/v1/tickets-staging/locations
GET https://api.voordemensen.nl/v1/tickets-staging/eventtypes
```

### Winkelwagen

#### Nieuwe winkelwagen
```
POST https://api.voordemensen.nl/v1/tickets-staging/cart
Response: { "cart_id": "abc123..." }
```

#### Tickets toevoegen
```
POST https://api.voordemensen.nl/v1/tickets-staging/cart/{cart_id}
Body: {
  "event_id": 123,
  "numberoftickets": 2,
  "discount_id": "encoded_hashid"
}
```

#### Bekijken/verwijderen
```
GET https://api.voordemensen.nl/v1/tickets-staging/cart/{cart_id}
DELETE https://api.voordemensen.nl/v1/tickets-staging/cart/{cart_id}/{seat_id}
```

### Bestelling plaatsen

```
POST https://api.voordemensen.nl/v1/tickets-staging/order/create
Content-Type: application/x-www-form-urlencoded

cart_id=abc123...
payment_id=33
email=klant@voorbeeld.nl
firstname=Jan
lastname=Jansen

Response: {
  "url": "https://www.mollie.com/checkout/...",
  "order_key": "uuid-here"
}
```

Redirect de gebruiker naar de `url` voor betaling via Mollie.

### Bestellingstatus
```
GET https://api.voordemensen.nl/v1/tickets-staging/order/{order_key}
```

---

## Server architectuur

| Server | URL | Functie |
|--------|-----|---------|
| API | api.voordemensen.nl | Lumen API voor alle endpoints |
| Tickets | tickets.voordemensen.nl | Order verwerking, betalingen |

Sommige GET endpoints redirecten naar tickets server. Volg redirects in je HTTP client.

## Contact
https://voordemensen.nl/contact