# Servicios REST Sin `Accept: text/html`, las operaciones de CRUD-L se comportan como un servicio [REST](https://es.wikipedia.org/wiki/Transferencia_de_Estado_Representacional) en JSON: no se usan las vistas, pero sí los modelos y controladores propios. La carga útil se envía en JSON y la respuesta es JSON. Todos los ejemplos de esta página son respuestas reales de Devkron 2.0 con MySQL 8, sobre el punto de entrada de [Instalación](/es/devkron/2.0/marcos/crudl/instalacion.md). ## Punto final ```text {ruta del sistema}/{tipo de entidad}/{identificador} ``` La forma exacta la da su regla de `routes.map` ([Enrutamiento](/es/devkron/2.0/marcos/crudl/enrutamiento.md)). Si la conexión viaja en la URL, `_app_group` y `_connection` pueden ser parte de la ruta. ## Autenticación El token de sesión va normalmente en el encabezado: ```text Authorization: Bearer TOKEN_DE_SESION ``` Otras ubicaciones en [webauth.dkl](/es/devkron/2.0/marcos/autenticacion/webauth.md). Si el token falta o es inválido, la petición no se rechaza por fuerza: puede atenderse con la conexión constante si el punto de entrada la tiene ([Conexión](/es/devkron/2.0/marcos/crudl/conexion-y-sesion.md)). ## CREATE | | | |---|---| | Método | `POST` | | Ruta | `.../{tipo}/` | | Cuerpo | La entidad en JSON (`Content-Type: application/json;charset=utf-8`) | | Respuesta | 200 y la entidad completa, releída de la base | ```bash curl -X POST http://misitio.localhost/tienda/cliente/ \ -H "Content-Type: application/json;charset=utf-8" \ -d '{"codigo":"CLI-0001","nombre":"Abarrotes López","saldo":1500.5}' ``` ```json {"sys_pk":1,"sys_guid":"316929d8e8b843659f22e40fa1e8c1b8","sys_dtcreated":"2026-10-27T23:30:24Z","sys_timestamp":"2026-10-27T23:30:24Z","sys_recver":0,"sys_deleted":null,"sys_lock":null,"codigo":"CLI-0001","nombre":"Abarrotes López","estado":"activo","saldo":1500.50} ``` La respuesta trae los campos de sistema asignados y los dependientes, si la entidad los declara. Las fechas salen en ISO 8601 en UTC. ## READ | | | |---|---| | Método | `GET` | | Ruta | `.../{tipo}/{identificador}` | | Respuesta | 200 y la entidad; 404 si no existe | ```text GET /tienda/cliente/1 → {"sys_pk":1, ..., "codigo":"CLI-0001", ...} GET /tienda/cliente/CLI-0001?_key=codigo → la misma entidad GET /tienda/cliente/99 → 404 {"message":"{404} Elemento no encontrado: {...}[Ln= 98]"} GET /tienda/cliente/_new → {} (o lo que devuelva @blank) ``` ## UPDATE | | | |---|---| | Métodos | `PUT` o `PATCH` | | Ruta | `.../{tipo}/{identificador}` | | Cuerpo | Los campos a cambiar, **con `sys_recver`** | | Respuesta | 200 y la entidad actualizada, con `sys_recver` aumentado | ```text PATCH /tienda/cliente/1 {"sys_recver":0,"saldo":2000} → {"sys_pk":1,...,"sys_recver":1,...,"saldo":2000.00} PATCH /tienda/cliente/1 {"sys_recver":0,"saldo":9} → 500 {"message":"{500} {1} Error en 'dbr.save. (Save Error. No fue posible actualizar la entidad..."} PATCH /tienda/cliente/CLI-0001?_key=codigo {"sys_recver":1,"estado":"suspendido"} → la entidad, sys_recver 2 ``` La segunda falla porque `sys_recver` ya no es 0: otro (aquí, la primera petición) guardó antes. Vuelva a leer y reintente. `PUT` y `PATCH` hacen lo mismo con el modelo genérico (los campos no enviados no se tocan); use `PUT` para enviar la entidad completa y `PATCH` para cambios parciales. Mande el identificador **en la URL**: con el identificador solo en el cuerpo (`PUT .../cliente/` con `{"sys_pk":1,...}`) el cambio se guarda, pero la relectura responde 404. ## DELETE | | | |---|---| | Método | `DELETE` | | Ruta | `.../{tipo}/{identificador}` | | Respuesta | 204 sin cuerpo | La baja predeterminada es física y no alcanza a los dependientes ([El modelo](/es/devkron/2.0/marcos/crudl/modelo.md#delete), [Maestro-detalle](/es/devkron/2.0/marcos/crudl/maestro-detalle.md#baja)). Con `sys_pk` como clave, un identificador que no existe también responde 204. ## LIST | | | |---|---| | Método | `GET` | | Ruta | `.../{tipo}/` | | Respuesta | 200 y un arreglo JSON | ```text GET /tienda/cliente/?estado=activo → [{"sys_pk":1,...,"estado":"activo",...}] ``` Filtros, orden y límite se resuelven en la consulta del modelo; cualquier parámetro de la URL está disponible en ella ([Filtros](/es/devkron/2.0/marcos/crudl/modelo.md#filtros-orden-y-paginación)). El marco no devuelve metadatos de paginación: si su cliente los necesita, publíquelos desde un `@list` propio o un punto final aparte. ## Identificadores Puede usar `sys_pk`, `sys_guid` o cualquier campo que indique con `_key`: ```text GET /tienda/cliente/CLI-0001?_key=codigo ``` Sin `_key` se asume `sys_pk`. Recuerde que los valores que llegan por la ruta de `routes.map` llegan en minúsculas ([Enrutamiento](/es/devkron/2.0/marcos/servidor-web/enrutamiento.md)). ## Errores Los errores se devuelven como JSON con un solo campo, `message`, y el estado HTTP del error: | Código | Situación | |---|---| | 200 | CREATE, READ, UPDATE y LIST correctos | | 204 | DELETE correcto | | 404 | Elemento no encontrado; operación no admitida; identidad no indicada; `Id no encontrado` | | 500 | Vista no disponible; errores de base de datos (concurrencia, restricciones); cualquier otro | Los errores de base de datos (concurrencia, llaves duplicadas, restricciones) llegan como 500 con el texto del motor en `message`. Para códigos más precisos, lance `rise_error` desde su modelo con el código HTTP deseado (cualquiera de 400 en adelante); por ejemplo, 409 por existencia insuficiente o 423 por un registro bloqueado. El mensaje incluye el código y la línea porque el servidor activa `errordet(@true)`. Para mensajes limpios, ponga `do errordet(@false)` en el punto de entrada. **Este formato no es el `{success, data}`.** CRUD-L responde la entidad sola y usa los códigos HTTP. Si necesita el formato `{success, data}` (siempre 200 con `success`), escriba un servicio propio como en [Servicio REST JSON](/es/devkron/2.0/guias/servicio-rest-json.md) o cambie `@success_view` y `@fail_view` por funciones que envuelvan el resultado. ## Deshabilitar operaciones Para una entidad de solo lectura, ponga en nulo los punteros en su `model.dk`: ```dkl ref @create = @null ref @update = @null ref @delete = @null ``` Las operaciones deshabilitadas responden 404 `Operación no admitida`. (En 2.0 no use `point @create to @null`: falla con `No existe una función '@null' declarada`.) ## Archivos El marco no procesa `multipart/form-data`. Para recibir archivos use la [API FSO](/es/devkron/2.0/marcos/fso/) o un punto final propio que lea `request/files` ([La petición](/es/devkron/2.0/marcos/servidor-web/http-context.md#archivos-subidos)).