Registrar placa
POST /api/plates
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra una placa para un cliente. Se guarda en mayúsculas y sin espacios al inicio o final; si ya estaba registrada no se duplica.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
person_id |
integer | Sí | Id del cliente (habilitado). |
value |
string | Sí | Placa (máx. 20). También se acepta en la clave plates. |
Reglas:
- Responde la lista completa de placas del cliente en
datay el id de la placa enid.
Errores:
- Validación:
422con{success: false, message: {campo: [mensajes]}}. - Cliente inexistente o inhabilitado: HTTP 200 con
success: false.
Cuerpo
Content-Type: application/json
{
"person_id": "1",
"value": "ABC-123"
}
Respuestas
200 — Guardada
{
"success": true,
"message": "Placa guardada con éxito",
"id": 5,
"data": [
{
"id": 5,
"value": "ABC-123"
}
]
}
422 — Validación
{
"success": false,
"message": {
"value": [
"El campo value es obligatorio."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.