# 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)).