Crear una reseña de negocio
API operation: Open the endpoint in Scalar
Usa POST /business/{business}/reviews para crear una reseña de un pedido. La operación descrita aquí es Review.register.
Parámetro:
{business}es el ID entero del negocio en la ruta.
El esquema documentado requiere order_id, quality, delivery, service y package. Un cliente con sesión iniciada puede reseñar su propio pedido; el personal autorizado puede actuar en nombre del cliente. Cuando el acceso por UUID para invitados está habilitado, un invitado puede enviar el hash correspondiente del pedido mediante X-uuid-access-X. No expongas ese hash en la documentación ni en los registros.
El pedido determina user_id y business_id; asegúrate de que pertenezca al negocio indicado en la ruta. No envíes una identidad de reseñador para sustituir la del pedido.
Consulta el modelo de reseñas de negocio.
Referencia de OpenAPI
Operación: POST /business/{business}/reviews
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
business | integer | Sí | — |
Parámetros de encabezado
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
X-uuid-access-X | string | No | — |
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
comment | any | No |
delivery | integer | Sí |
enabled | boolean | No |
order_id | integer | Sí |
package | integer | Sí |
quality | integer | Sí |
quality_tags | array | null | No |
service | integer | Sí |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Respuesta de error para el código declarado por la operación. Consulta result para ver los detalles disponibles. Envelope de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |