Gere marcações com clientes. Cria consultas, provas e marcações de levantamento.
/api/vendor/appointmentsDevolve marcações, opcionalmente filtradas por período.
Requer scope: appointments:read
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"/api/vendor/appointmentsCria uma nova marcação para um cliente existente.
Requer scope: appointments:write
| Field | Type | Description | |
|---|---|---|---|
| customerId | string | Obrigatório | ID do cliente (CUID) |
| type | string | Obrigatório | Tipo de marcação |
| date | string | Obrigatório | Data e hora (ISO 8601) |
| duration | number | Opcional | Duração em minutos (15–480, padrão: 60) |
| notes | string | Opcional | Notas sobre a marcação |
| orderId | string | Opcional | Encomenda associada (opcional) |
Tipo de marcação
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"
}'As marcações passam pelos seguintes estados:
PROPOSED → CONFIRMED, PROPOSED → CANCELLED, CONFIRMED → COMPLETED, CONFIRMED → CANCELLED
/api/vendor/appointments/:idAtualiza uma marcação. As transições de estado são validadas.
Requer scope: appointments:write
/api/vendor/appointments/:idElimina uma marcação. Só é possível com o estado PROPOSED ou CANCELLED.
Requer scope: appointments:write