# Probar servicios web en la consola Un servicio o una página de Devkron lee la petición de `@http_context` y escribe ahí su respuesta. En la consola esa variable no existe, pero se puede **armar a mano**: así se prueba un servicio sin servidor web, se reproduce un error con los datos exactos de una petición y se escriben pruebas automáticas. ## El servicio `sitio/api/cliente.dkl`, un servicio JSON hecho con `http.dkh`: ```text #include "dkli.dkh" #! program "api-cliente" { #include "functions.dkh" #include "serialize.dkh" #include "http.dkh" id = httpreq.num("id") if id <= 0 { do httpres.fail("Falta el id") do httpres.status(400) return } new cliente { @"id": id @"nombre": "Cliente " + str(id) @"metodo": httpreq.method() } do httpres.ok(cliente) } ``` `httpres.ok` y `httpres.fail` fijan HTTP 200; por eso `httpres.status(400)` va después. ## El programa de prueba `probar.dkl`, junto a la carpeta `sitio/`: ```text #include "dkli.dkh" #! program "probar-servicio" { #include "functions.dkh" #include "serialize.dkh" // Ejecuta el servicio en una función aparte (ver "Dos detalles") ejecutar::archivo { include archivo return 1 } llamar::archivo, metodo, valor_id, cuerpo { ref @http_context = from.json('{"request":{"get":{},"post":{},"headers":{},"cookies":{}},"response":{"headers":{}}}') @http_context<"request/get/id">: valor_id @http_context<"request/headers/REQUEST_METHOD">: metodo @http_context<"request/POST_STRING">: cuerpo terminado = ejecutar(archivo) estado = @@(@http_context, "#response/http_status") return metodo + " -> HTTP " + ifstr(estado == 0, "200", str(estado)) + " " + @@(@http_context, "response/text") } do print(llamar("sitio/api/cliente.dkl", "GET", "5", "")) do print(llamar("sitio/api/cliente.dkl", "GET", "0", "")) } ``` ```text $ dkl probar.dkl -hide-log GET -> HTTP 200 {"success":true,"data":{"id":5,"nombre":"Cliente 5","metodo":"GET"}} GET -> HTTP 400 {"success":false,"message":"Falta el id"} ``` Qué se arma en `@http_context`: | Ruta | Qué simula | |---|---| | `request/get/` | parámetros de la URL (y los de `routes.map`) | | `request/post/` | campos de un formulario | | `request/POST_STRING` | cuerpo crudo (JSON) que leen `httpreq.body()` y `httpreq.json()` | | `request/headers/REQUEST_METHOD` | método que devuelve `httpreq.method()` | | `request/headers/` | encabezados (`HTTP_HOST`, `HTTP_AUTHORIZATION`…) | Y qué se revisa después: `response/http_status` (0 si el servicio no lo fijó, que el servidor envía como 200), `response/headers/…`, `response/output` y `response/text`. ## Dos detalles de `include` - `include archivo` (sin `#`) analiza el archivo como un documento propio y lo ejecuta **en el ámbito de quien lo incluye**. Si el servicio usa una variable con el mismo nombre que una de quien lo incluye pero de otro tipo, falla con `ya fué inicializada con un tipo diferente`. Por eso se incluye dentro de una función aparte. - Un `return` del servicio sale de la función que hizo el `include` (aquí, `ejecutar`, que entonces devuelve 0). Con eso se sabe si el servicio terminó antes. ## Límites - `httpreq.ip()`, `httpreq.is_https()` y similares leen encabezados que el servidor agrega: agréguelos al contexto si el servicio los usa. - Las subidas de archivos (`request/files`) y las respuestas binarias se simulan igual, pero con más trabajo. - Para probar el servidor completo (rutas, encabezados reales, códigos HTTP), use `dklwebsvr` o nginx con FastCGI y `curl`. Para conectores de Devkron Edge, `dkle run` simula la petición sin abrir puertos.