# PhotoCare Grenaa — Studie-booking

> Fotostudie i Grenaa (Djursland, Danmark). Book portræt-, baby-, familie-,
> erhvervs- og pasfoto-fotograferinger online. Denne side beskriver hvordan
> AI-agenter kan finde ledige tider og booke på vegne af en kunde via vores
> åbne JSON-API — uden login.

Butik: PhotoCare Grenaa, Storegade 4, 8500 Grenaa · tlf. 86 32 68 33
Booking-side (mennesker): /book

## Booking-API (JSON, ingen auth)

Alle svar er JSON (UTF-8). Datoer er YYYY-MM-DD, tider er HH:MM (dansk tid).
Flowet er 4 trin — kald dem i rækkefølge:

1. `GET /api/book/typer`
   → `{ typer: [{ id, navn, beskrivelse, varighed_min, fra_pris, ... }] }`
   Vælg fototypens `id`. Kun aktive, offentligt bookbare typer vises.

2. `GET /api/book/fotografer?type=<typeId>`
   → `{ fotografer: [{ id, navn, ... }] }`
   Vælg fotografens `id` (kunden må gerne vælge frit).

3. `GET /api/book/tider?type=<typeId>&fotograf=<fotografId>&dato=<YYYY-MM-DD>`
   → `{ tider: ["10:00", "10:30", ...] }` — ledige starttider den dag.
   Tom liste + evt. `grund` ("weekend", "helligdag", "ferie", …) = intet ledigt.
   Find første ledige tid ved at kalde for én dato ad gangen, fremad fra i dag.

4. Valgfrit: `GET /api/book/pakker?type=<typeId>`
   → `{ pakker: [...], tilkoeb: [...], obs }` — forudbetalte pakker/tilkøb.

5. `POST /api/book/opret` med JSON-body:
   `{ typeId, fotografId, dato, tid, navn, telefon, email, kommentar?, pakkeId?, tilkoebValg?, gdpr: true }`
   → `{ ok: true, bookingId, kode }` — kunden får bekræftelse på mail/SMS.
   VIGTIGT: `gdpr: true` må KUN sendes hvis slutbrugeren faktisk har givet
   samtykke til at vi gemmer navn/telefon/email til bookingen.
   Ved "Ny borger"-typer kan `babyNavn`, `babyFoedselsdato`, `babyMor`,
   `babyFar` medsendes.

Maskinlæsbar oversigt over alle endpoints: `GET /api/book` (JSON).

## MCP-server (anbefalet til AI-assistenter)

Vi har en MCP-server (Model Context Protocol, Streamable HTTP, ingen auth):

    https://studie.photocaregrenaa.dk/api/mcp

Værktøjer — booking: `find_fototyper`, `find_fotografer`, `find_ledige_tider`
(understøtter scanning af op til 14 dage), `find_pakker`, `book_tid`.
Galleri-shopping (kræver kundens galleri-kode): `se_galleri`, `se_prisliste`,
`bestil_billeder`. Gavekort: `koeb_gavekort`.
Tilføj URL'en som custom connector i din AI-klient, så klarer værktøjerne
hele flowet — inkl. samtykke-kravene.

VIGTIGT om køb: agenter kan ALDRIG betale. Ordrer og gavekort afsluttes
altid med et betalingslink, som kunden/køberen selv åbner og betaler.
Gemte betalingskort kan hverken bruges eller gemmes via API/MCP.

## Regler for agenter

- Book kun med en rigtig kundes viden og samtykke; brug kundens egne
  kontaktoplysninger (bekræftelsen sendes dertil).
- Aflysning/flytning sker via linket i kundens bekræftelses-mail.
- Opret ikke test-bookinger i produktion.