Gestisci gli ordini dei clienti tramite la Orders API. Crea nuovi ordini, recupera quelli esistenti e aggiorna lo stato.
/api/vendor/ordersRestituisce gli ultimi 100 ordini del vendor, ordinati per ultimo aggiornamento.
curl -s https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here"Risposta
{
"orders": [
{
"id": "cm...",
"type": "BRIDAL_DRESS",
"status": "ORDERED",
"model": "Valentina A-Line",
"size": "38",
"color": "Ivory",
"description": "Custom bridal dress",
"specialRequests": "Extra lace on sleeves",
"customer": {
"name": "Anna Müller",
"email": "anna@example.com"
},
"updates": [
{
"status": "ORDERED",
"message": "Order created via API",
"createdAt": "2026-03-10T14:30:00.000Z"
}
],
"createdAt": "2026-03-10T14:30:00.000Z",
"updatedAt": "2026-03-10T14:30:00.000Z"
}
]
}/api/vendor/ordersCrea un nuovo ordine cliente. Se esiste già un cliente con la stessa email, viene associato automaticamente.
Request Body
| Field | Type | Description | |
|---|---|---|---|
| customerName | string | Campo obbligatorio | Nome del cliente |
| type | enum | Campo obbligatorio | Tipo di ordine: BRIDAL_DRESS, SUIT, RENTAL |
| customerEmail | string | Facoltativo | Indirizzo email del cliente |
| customerPhone | string | Facoltativo | Numero di telefono del cliente |
| weddingDate | string | Facoltativo | Data del matrimonio (ISO 8601) |
| model | string | Facoltativo | Nome del modello |
| description | string | Facoltativo | Descrizione dell'ordine |
| size | string | Facoltativo | Taglia |
| color | string | Facoltativo | Colore |
| specialRequests | string | Facoltativo | Richieste speciali |
curl -X POST https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"customerName": "Anna Müller",
"customerEmail": "anna@example.com",
"type": "BRIDAL_DRESS",
"model": "Valentina A-Line",
"size": "38",
"color": "Ivory"
}'Risposta (201)
{ "id": "cm...", "status": "ORDERED" }/api/vendor/orders/{id}/statusAggiorna lo stato di un ordine esistente. È possibile allegare un messaggio opzionale e un'immagine.
Request Body
| Field | Type | Description | |
|---|---|---|---|
| status | enum | Campo obbligatorio | Nuovo stato |
| message | string | Facoltativo | Messaggio di stato per il cliente |
| imageUrl | string | Facoltativo | URL di un'immagine (es. foto di avanzamento lavori) |
curl -X PUT https://brutlers.com/api/vendor/orders/ORDER_ID/status \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"status": "IN_PRODUCTION",
"message": "Fabric has been cut, starting assembly."
}'Risposta
{ "id": "cm...", "status": "IN_PRODUCTION" }