Pedido del comensal
POST
Calificar un plato del pedido
POST /api/orders/set-product-review
Descripción
Guarda las estrellas y el comentario del cliente sobre un plato que pidió.
Detalles
Guarda la calificación de 1 a 5 estrellas de un plato aprobado del pedido, con un comentario opcional. Cada plato se califica una sola vez aunque se haya pedido varias veces: volver a calificarlo la reemplaza. Suma al promedio del plato en la carta y queda marcada como compra verificada.
Permisos requeridos
auth-order
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| productUuid | string | Sí |
min:36
max:36
|
| ratingValue | int | Sí |
min_value:1
max_value:5
|
| body | string | No |
max:500
|
Respuesta
Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.
| Campo | Tipo | Descripción |
|---|---|---|
| orderUuid | string | Identificador del pedido |
| reviewUuid | string | Identificador de la calificación |
| productUuid | string Admite vacío | Plato calificado, o vacío en la de la atención |
| ratingValue | int | Estrellas de 1 a 5 |
| body | string | Comentario, vacío si no dejó |
| isNew | bool | Si es la primera vez que califica o reemplazó la anterior |
Ejemplo de request
curl -X POST https://restofy.pro/api/orders/set-product-review \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"productUuid": "string",
"ratingValue": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.