Appointments API

Gestisci gli appuntamenti con i clienti. Crea consulenze, prove d'abito e appuntamenti per il ritiro.

GET

/api/vendor/appointments

Restituisce gli appuntamenti, opzionalmente filtrati per periodo.

Richiede scope: appointments:read

bash

curl -s "https://brutlers.com/api/vendor/appointments?from=2026-04-01&to=2026-04-30" \
  -H "X-Api-Key: brut_your_api_key_here"

POST

/api/vendor/appointments

Crea un nuovo appuntamento per un cliente esistente.

Richiede scope: appointments:write

Request Body

Field	Type		Description
customerId	string	Campo obbligatorio	ID del cliente (CUID)
type	string	Campo obbligatorio	Tipo di appuntamento
date	string	Campo obbligatorio	Data e ora (ISO 8601)
duration	number	Facoltativo	Durata in minuti (15–480, default: 60)
notes	string	Facoltativo	Note sull'appuntamento
orderId	string	Facoltativo	Ordine collegato (facoltativo)

Tipo di appuntamento

CONSULTATION — ConsulenzaFITTING — Prova d'abitoPICKUP — RitiroALTERATION — Modifica

bash

curl -X POST https://brutlers.com/api/vendor/appointments \
  -H "X-Api-Key: brut_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "clx1234567890abcdef",
    "type": "CONSULTATION",
    "date": "2026-04-15T10:00:00Z",
    "duration": 60,
    "notes": "Erstberatung Brautkleid"
  }'

Transizioni di stato

Gli appuntamenti attraversano i seguenti stati:

Proposto→Confermato→Completato|Annullato

PROPOSED → CONFIRMED, PROPOSED → CANCELLED, CONFIRMED → COMPLETED, CONFIRMED → CANCELLED

PUT

/api/vendor/appointments/:id

Aggiorna un appuntamento. Le transizioni di stato vengono validate.

Richiede scope: appointments:write

DELETE

/api/vendor/appointments/:id

Elimina un appuntamento. Possibile solo se in stato PROPOSED o CANCELLED.

Richiede scope: appointments:write