Ir al contenido

Crear una categoría

POST/api/category

Crea una categoría. El servidor calcula level (1 si no hay padre; el nivel del padre más uno si lo hay), guarda la categoría con estado activo, asigna al usuario autenticado como creador y responde 201. Si el padre ya está en el nivel 3, responde 422 con la clave category_father_id.

namestringobligatorio

Nombre de la categoría. Máximo 60 caracteres; solo letras, números y espacios. Debe ser único, también frente a categorías eliminadas.

descriptionstring

Descripción. Máximo 500 caracteres.

category_father_idinteger

Categoría padre. Debe existir en categorías. Si se omite, la categoría es raíz.

filestring

Se acepta en la validación, pero CategoryController no lo procesa (el código que guardaba la imagen está comentado).

file_extensionstring

Se acepta en la validación, pero CategoryController no lo procesa.

quotation.configuration.create, que se valida en CategoryPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/category" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Cables",
"description": "Cables eléctricos"
}'
Categoría creada201
{
"id": 1,
"name": "Cables",
"description": "Cables eléctricos",
"image": null,
"thumbnail": null,
"level": 1,
"category_father_id": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Error de validación422
{
"message": "El nombre de la categoría ya existe",
"errors": {
"name": [
"El nombre de la categoría ya existe"
]
}
}
Error de validación422
{
"message": "No se puede crear esta categoría dentro del nivel máximo",
"errors": {
"category_father_id": [
"No se puede crear esta categoría dentro del nivel máximo"
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}