Explicación de la idempotencia de API: Claves de idempotencia y reintentos seguros, probados
La idempotencia de API significa que enviar la misma solicitud dos veces tiene el mismo efecto que enviarla una vez. Descubra qué métodos HTTP son idempotentes, por qué POST necesita una clave de idempotencia y cómo crear una de forma segura con una demostración de Python que convirtió una carga doble en una sola.
- Idempotencia de API significa que repetir una solicitud no repite su efecto secundario. GET, PUT y DELETE son idempotentes por definición; La publicación no lo es.
- En nuestra demostración, una respuesta perdida seguida de un reintento generó dos cargos sin clave y uno con
Idempotency-Key. - Almacenar una huella digital del cuerpo de la solicitud con la clave: reutilizar una clave con un cuerpo diferente devuelta 422 en nuestro servidor.
- Reclama la clave de forma atómica. Dos reintentos simultáneos obtuvieron 201 y 409, y solo se realizó un cargo.
Las redes fallan en el peor lugar posible: después de que el servidor haya hecho el trabajo pero antes de que el cliente reciba respuesta. El cliente ve un tiempo de espera, lo vuelve a intentar y se le cobra dos veces o se envía un pedido dos veces. La idempotencia de API es la regla de diseño que hace que esos reintentos sean seguros, y las claves de idempotencia son la forma estándar de aplicarla a las solicitudes que crean cosas.
Para mostrar el problema en lugar de describirlo, escribimos una pequeña API de pago con el servidor HTTP integrado de Python 3.13 y un cliente que reintenta después de una conexión interrumpida. Todo se ejecutó localmente y los resultados a continuación se copian de esa ejecución. Los proveedores de pagos reales añaden mucho más, así que trate el código como un modelo de enseñanza. Para conocer el diseño general de API, consulte nuestras mejores prácticas de API REST.
¿Qué es la idempotencia?
Una operación es idempotente si al realizarla una o muchas veces deja el sistema en el mismo estado. Poner un interruptor de luz en “apagado” es idempotente: presionar “apagado” cinco veces aún lo deja apagado. Alternar el interruptor no lo es, porque cada pulsación cambia el resultado.
Tenga en cuenta que la idempotencia se trata del efecto en el servidor, no de la respuesta. Eliminar una orden dos veces es idempotente incluso si la segunda llamada devuelve 404, porque la orden desaparece de cualquier manera. Una palabra relacionada, seguro, significa que la solicitud no cambia nada en absoluto, como GET.
¿Qué métodos HTTP son idempotentes?
La especificación HTTP, RFC 9110, define estas propiedades para cada método:
| Método | Seguro | idempotente | Uso típico |
|---|---|---|---|
| OBTENER, CABEZA, OPCIONES | si | si | leer datos |
| poner | No | si | Reemplazar un recurso en una URL conocida |
| BORRAR | No | si | Eliminar un recurso |
| PUBLICAR | No | No | Crear un recurso o desencadenar una acción |
| PARCHE | No | No garantizado | Actualización parcial |
La tabla describe lo que los servidores deben hacer. Un PUT mal diseñado que incrementa un contador rompe la promesa. Y PATCH depende de la carga útil: “establecer la cantidad en 3” es idempotente, mientras que “agregar 1 a la cantidad” no lo es. Nuestra hoja de referencia de códigos de estado HTTP enumera las respuestas que normalmente devuelve cada método.
El problema del reintento
Un cliente envía POST /payments. Pueden pasar tres cosas:
- La solicitud nunca llega al servidor. Volver a intentarlo es seguro.
- El servidor lo procesa y llega la respuesta. No es necesario volver a intentarlo.
- El servidor lo procesa, pero la respuesta se pierde debido a un tiempo de espera o a una conexión interrumpida. El cliente no puede distinguir esto del caso 1.
El caso 3 es el peligroso. Si el cliente vuelve a intentarlo, el servidor crea un segundo pago. Si no lo vuelve a intentar, nunca se realizará un pago que falló en el caso 1. Sin la ayuda del servidor, el cliente no tiene una opción segura.
Cómo funcionan las claves de idempotencia
La solución es darle a cada operación lógica una identificación única que el servidor recuerde:
- El cliente genera una clave aleatoria, normalmente un UUID, y la envía en un encabezado como
Idempotency-Key. - El servidor comprueba si ha visto la clave. Si no, registra la clave, hace el trabajo y almacena la respuesta con la clave.
- Si vuelve a llegar la misma clave, el servidor omite el trabajo y devuelve la respuesta almacenada.
- Las claves caducan después de un período de retención, generalmente alrededor de 24 horas, aunque varía según el proveedor.
Los proveedores de pagos popularizaron el patrón y un borrador de estándar del IETF describe el encabezado Idempotency-Key para las API HTTP en general.
Nuestro servidor de demostración
El corazón del servidor son unas pocas líneas que reclaman la clave, luego hacen el trabajo o reproducen el resultado almacenado:
key = self.headers.get("Idempotency-Key")
fp = hashlib.sha256(body).hexdigest() # fingerprint of the request
if key:
with lock: # atomic claim
rec = keys.get(key)
if rec is None:
keys[key] = {"fp": fp, "state": "processing"}
if rec:
if rec["fp"] != fp:
return self.reply(422, {"error": "key reused with different body"})
if rec["state"] == "processing":
return self.reply(409, {"error": "request in progress"})
return self.reply(rec["status"], rec["body"], replay=True)
charges.append(data["amount"]) # the side effect
out = {"charge_id": f"ch_{len(charges)}", "amount": data["amount"]}
if key:
keys[key].update(state="done", status=201, body=out)
Para simular el caso 3, se le puede indicar al servidor que complete la carga y luego cierre la conexión sin responder. El cliente ve un error y vuelve a intentarlo con la solicitud idéntica.
Resultados: con y sin llave
no key, attempt 1: ('ERR', 'RemoteDisconnected', None)
no key, retry: (201, {'charge_id': 'ch_2', 'amount': 500}, None)
charges without key: [500, 500]
key, attempt 1: ('ERR', 'RemoteDisconnected', None)
key, retry: (201, {'charge_id': 'ch_1', 'amount': 500}, 'true')
charges with key: [500]
Sin una clave, al cliente se le cobró 500 dos veces y el cliente solo vio el cargo ch_2; La primera carga se volvió invisible. Con una clave, el reintento recibió la respuesta original, ch_1, con un encabezado Idempotent-Replayed: true y solo existe un cargo. El cliente obtuvo exactamente la respuesta que se perdió la primera vez.
Consejo: reproduzca la respuesta almacenada, incluido el código de estado. Devolver un mensaje diferente, como “solicitud duplicada”, obliga a cada cliente a escribir un manejo especial y anula el punto.
Reutilizar una llave con un cuerpo diferente
Una clave debe identificar una operación. Si un cliente envía accidentalmente la misma clave con un monto diferente, reproducir la respuesta anterior sería incorrecto, al igual que cobrar el nuevo monto. Nuestro servidor almacena una huella digital SHA-256 del cuerpo con la clave y la compara:
same key same body: 201 (replayed)
same key different body: (422, {'error': 'key reused with different body'})
Negarse en voz alta convierte un error silencioso del cliente en uno obvio. Los proveedores difieren en cuanto al código de estado exacto; el borrador del IETF sugiere 422 para este caso.
Reintentos simultáneos
Los clientes agresivos a veces vuelven a intentarlo antes de que finalice el primer intento. Si el servidor verifica la clave y luego la inserta en dos pasos separados, ambas solicitudes pueden pasar la verificación y ambas pueden cobrar. Enviamos dos solicitudes idénticas con la misma clave al mismo tiempo, y el trabajo tardó medio segundo:
concurrent same key: [201, 409] charges: [700]
Una solicitud ganó el reclamo atómico y cargó; el otro vio la clave en el estado processing y obtuvo el conflicto 409, que le dice al cliente que espere y vuelva a intentarlo. En producción, el bloqueo se reemplaza por una restricción única de la base de datos o una operación atómica de “insertar si está ausente” como Redis SET NX, por lo que funciona en muchos servidores.
Lista de verificación del diseño del servidor
- Claves de alcance para la cuenta o clave API, para que dos clientes no puedan colisionar.
- Reclamar antes de trabajar, de forma atómica, y registrar un estado
processing. - Almacena la respuesta completa, estado y cuerpo, cuando finalice el trabajo.
- Tomar huellas dactilares de la solicitud y rechazar la reutilización no coincidente.
- Maneje las fallas deliberadamente. Si el trabajo falla debido a un error del servidor, libere la clave para que pueda volver a intentarlo; si falla la validación, almacene y reproduzca el error.
- Caducar las claves después de una ventana documentada y mantener el efecto secundario y el registro de claves en la misma transacción siempre que sea posible.
- También haga que los pasos internos sean idempotentes. Los consumidores de mensajes y los controladores webhook reciben duplicados, por lo tanto, elimine los duplicados en un ID de evento.
Reglas del lado del cliente
- Genere una clave por operación lógica, no por intento HTTP, y reutilícela para cada reintento de esa operación.
- Vuelva a intentarlo solo en caso de errores de red, tiempos de espera, respuestas 409, 429 y 5xx, con retroceso y fluctuación exponencial. Nuestra guía de limitación de tasas API explica el retroceso.
- Nunca vuelva a intentar un error de validación 4xx sin cambios; fallará de la misma manera.
- Conserve la clave con la operación pendiente, para que una aplicación reiniciada pueda volver a intentarlo de forma segura.
Cómo probar la idempotencia
Los errores de idempotencia se ocultan hasta que el tráfico de producción es confuso, así que pruébelos a propósito. Envíe la misma solicitud dos veces y afirme que existe un recurso. Envíe la misma clave con un cuerpo diferente y confirme el error. Encienda solicitudes paralelas con una clave y afirme un único efecto secundario, como lo hizo nuestra prueba concurrente. Elimine la conexión después de que el servidor se confirme, utilizando un proxy o un enlace de prueba, y verifique que el reintento obtenga la respuesta original. Estas comprobaciones encajan naturalmente en las pruebas de API creadas con las herramientas de nuestra guía de pruebas de API con Postman.
Conclusión
La idempotencia de API convierte los reintentos de un riesgo a una rutina. Utilice métodos naturalmente idempotentes cuando encajen y proporcione a cada POST que mueva dinero o cree registros importantes una clave de idempotencia. En el servidor, reclame claves de forma atómica, almacene y reproduzca respuestas completas y rechace la reutilización con un cuerpo diferente. Nuestra pequeña demostración mostró la diferencia en una línea: dos cargas se convirtieron en una.
Preguntas frecuentes
¿Qué es la idempotencia en una API?
Una operación API es idempotente cuando realizar la misma solicitud varias veces tiene el mismo efecto en el servidor que hacerlo una vez, por lo que los clientes pueden volver a intentarlo de forma segura.
¿POST es idempotente?
No. POST normalmente crea un nuevo recurso o desencadena una acción cada vez. Agregue una clave de idempotencia para que el servidor pueda reconocer e ignorar de forma segura los intentos repetidos.
¿Qué es una clave de idempotencia?
Es un valor único, a menudo un UUID, que el cliente envía con una solicitud. El servidor almacena el resultado bajo esa clave y devuelve el mismo resultado si se vuelve a ver la clave.
¿Cuánto tiempo se deben almacenar las claves de idempotencia?
El tiempo suficiente para cubrir cada reintento realista. Lo común es alrededor de 24 horas, pero los proveedores difieren, así que documente su ventana y caduque las claves antiguas.
¿Qué debería devolver el servidor en caso de una solicitud duplicada?
Devuelve la respuesta original almacenada con el mismo código de estado y cuerpo. Si el original aún se está ejecutando, devuelva 409 para que el cliente vuelva a intentarlo más tarde.
sigue aprendiendo
¿Necesitas ayuda con pruebas, WordPress o SEO?
Ayudamos a los equipos a enviar mejor software y hacer crecer sus sitios. Cuéntenos en qué está trabajando y le sugeriremos un siguiente paso claro.
Más guías sobre testing, IA y desarrollo moderno
¿Te gustó este artículo? Elige un tema y salta directo a nuestros tutoriales más recientes.
Explicación de las estrategias de fragmentación de RAG: fija, superpuesta, de oración, recursiva y de títulos, medida
Estrategias de fragmentación de RAG comparadas en un documento con tiktoken 0.14: tamaño fijo, superposición, empaquetado de oraciones, división rec…
Leer artículo →Desarrollo de softwareExplicación de la idempotencia de API: claves de idempotencia y reintentos seguros, probados
La idempotencia de API se explicó con un servidor y cliente Python que ejecutamos: una respuesta perdida provocó un cargo doble sin una clave y un c…
Leer artículo →DevOpsExplicación de Git Stash: guardar, aplicar, extraer y archivos sin seguimiento, probado
Git stash se explica con comandos que ejecutamos en Git 2.56: enviar con un mensaje, archivos sin seguimiento, enumerar y mostrar, aplicar frente a …
Leer artículo →Pruebas de softwareExplicación de las pruebas por pares: cómo todos los pares reducen 216 pruebas a 13, probadas
Pruebas por pares explicadas con un generador que ejecutamos en Python 3.13: una comprobación con 216 combinaciones cubiertas por 13 pruebas, cobert…
Leer artículo →Automatización de pruebasExplicación de los dobles de prueba: ficticio, stub, espía, simulado y falso, con código Python probado
Los dobles de prueba se explican con un ejemplo de Python ejecutado en pytest 9.2: ficticio, stub, spy, simulado y falso, cuándo usar cada uno, veri…
Leer artículo →Bases de datos y SQLSQL COALESCE explicado: valores predeterminados, NULLIF, IFNULL vs ISNULL y trampas, probados
SQL COALESCE se explica con consultas que ejecutamos en SQLite 3.50: primeros valores no nulos, cadenas vacías, NULL en matemáticas, NULLIF para div…
Leer artículo →Bases de datos y SQLExplicación de la autounión de SQL: empleado-gerente, comparaciones de pares y filas, probado
La autounión de SQL se explica con consultas que ejecutamos en SQLite 3.50: empleado y gerente, ganando más que el gerente, pares únicos, cambios di…
Leer artículo →Desarrollo de softwareExplicación del operador de extensión de JavaScript: extensión frente a reposo, copias y errores, probado
El operador de extensión de JavaScript explicado con el código que ejecutamos en el Nodo 24: matrices, objetos, copias superficiales, parámetros de …
Leer artículo →Desarrollo de softwareExplicación del módulo de colecciones de Python: contador, defaultdict, deque y más, probado
Colecciones de Python explicadas con el código que ejecutamos en Python 3.13: Counter, defaultdict, deque, namedtuple, OrderedDict y ChainMap, ademá…
Leer artículo →Inteligencia artificialExplicación de la ventana de contexto de LLM: tokens, límites y cómo ajustar más, medidos
La ventana de contexto de LLM se explica con recuentos de tokens que medimos usando tiktoken: palabras frente a tokens para prosa, código e hindi, p…
Leer artículo →Desarrollo de softwareExplicación de los webhooks: cómo funcionan y cómo recibirlos de forma segura
Webhooks explicados con un receptor y un remitente que ejecutamos en Python: push vs polling, firmas HMAC-SHA256, rechazo de solicitudes manipuladas…
Leer artículo →DevOpsExplicación de Git Cherry-Pick: copie la confirmación que necesita, de forma segura y probada
Git cherry-pick explicado con comandos que ejecutamos en Git 2.56: copiar una revisión a una rama de lanzamiento, nuevos hashes e ID de parche, -x, …
Leer artículo →Automatización de pruebasExplicación de las pruebas instantáneas: cómo funciona, cuándo ayuda y cuándo duele
Las pruebas de instantáneas se explican con una demostración de pytest y jarabe que ejecutamos: crear instantáneas, leer la diferencia después de un…
Leer artículo →Pruebas de softwareExplicación de las pruebas de mutación: por qué la cobertura del 100% aún no detectó nuestro error
Las pruebas de mutación se explican con una pequeña herramienta de mutación que construimos y ejecutamos: 14 mutantes, un conjunto de pruebas con un…
Leer artículo →Inteligencia artificialExplicación de la inyección rápida: cómo se engaña a las aplicaciones de inteligencia artificial y cómo defenderlas
Inyección rápida explicada para los constructores: ataques directos e indirectos, por qué fallan los filtros de palabras clave (nuestra prueba bloqu…
Leer artículo →DevOpsRegistros DNS explicados: A, AAAA, CNAME, MX, TXT y TTL con búsquedas reales
Los registros DNS se explican con las búsquedas que realizamos: cómo funciona la resolución, A y AAAA, reglas CNAME, MX y MX nulo, TXT para SPF y ve…
Leer artículo →DevOpsExplicación de las banderas de funciones: lanzamientos seguros, implementaciones graduales e higiene de las banderas
Indicadores de características explicados con una simulación de implementación que ejecutamos: tipos de indicadores, porcentajes de implementación c…
Leer artículo →Automatización de pruebasGeneración de datos de prueba con Python Faker: datos realistas, repetibles y seguros
Pruebe la generación de datos con Python Faker, ejecute y mida: siembra de datos repetibles, configuraciones regionales, valores únicos, registros e…
Leer artículo →Pruebas de softwareExplicación de las pruebas de cambio a la izquierda: encuentre errores antes sin ralentizar al equipo
Se explicaron las pruebas de desplazamiento a la izquierda: qué significa, por qué los defectos tempranos son más baratos, prácticas desde revisione…
Leer artículo →Bases de datos y SQLFunciones de cadenas SQL explicadas: TRIM, SUBSTR, REPLACE, CONCAT y limpieza de datos
Funciones de cadena SQL explicadas con consultas que ejecutamos: concatenación y NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, relleno, longit…
Leer artículo →Bases de datos y SQLExplicación de los activadores de SQL: ANTES y DESPUÉS de los activadores, registros de auditoría y errores
Los disparadores de SQL se explican con los disparadores que ejecutamos: ANTES versus DESPUÉS, ANTIGUOS y NUEVOS, registros de auditoría, validación…
Leer artículo →Desarrollo de softwareMódulo Python JSON explicado: volcados, cargas, tipos personalizados y errores comunes
El módulo Python JSON explicado con el código que ejecutamos: volcados y cargas, archivos, conversiones de tipos, fechas y decimales, codificadores …
Leer artículo →Desarrollo de softwareMódulos ES frente a CommonJS: cómo funcionan las importaciones de JavaScript en Node.js, probado
Los módulos ES frente a CommonJS se explican con el código que ejecutamos en Node.js: sintaxis de importación y exportación, requisitos, enlaces en …
Leer artículo →Desarrollo de softwarePython Regex explicado: patrones, grupos, anticipaciones y obstáculos, probados
La expresión regular de Python se explica con los patrones que ejecutamos: búsqueda versus coincidencia, búsqueda, grupos y grupos con nombre, codic…
Leer artículo →Inteligencia artificialExplicación del resultado estructurado de LLM: obtención de JSON confiable a partir de modelos de IA
La salida estructurada de LLM se explica con la validación que ejecutamos en Pydantic: modo y esquemas JSON, decodificación restringida, las formas …
Leer artículo →DevOpsExplicación de las claves SSH: cómo funcionan, ssh-keygen, Ed25519 y hábitos seguros
Claves SSH explicadas con las claves que generamos: claves públicas versus privadas, ssh-keygen, Ed25519 versus RSA, huellas digitales, frases de co…
Leer artículo →DevOpsExplicación del almacenamiento en caché HTTP: control de caché, ETag y respuestas 304, con una prueba en vivo
El almacenamiento en caché HTTP se explica con un pequeño servidor que ejecutamos: directivas Cache-Control, edad máxima, sin caché versus sin almac…
Leer artículo →Automatización de pruebasExplicación de las pruebas de contrato API: detecte los cambios importantes antes de enviarlos
Las pruebas de contratos API se explican con una verificación de esquema que ejecutamos: qué es un contrato, contratos impulsados por el consumidor,…
Leer artículo →Pruebas de softwareExplicación de las pruebas basadas en riesgos: calificar los riesgos, crear una matriz y probar lo que importa
Pruebas basadas en riesgos explicadas paso a paso: identificación de riesgos, puntuación de probabilidad e impacto, creación de una matriz de riesgo…
Leer artículo →Bases de datos y SQLExplicación de las restricciones de SQL: NOT NULL, UNIQUE, CHECK y FOREIGN KEY, probado
Las restricciones de SQL se explican con las pruebas que ejecutamos: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY y FOREIGN KEY, las lagunas NULL, la c…
Leer artículo →Bases de datos y SQLFunciones de fecha SQL explicadas: agregar, comparar y agrupar fechas sin errores
Funciones de fecha SQL explicadas con consultas que ejecutamos: agregar intervalos, sorpresas de fin de mes, diferencias de fechas, trampa ENTRE, ag…
Leer artículo →Desarrollo de softwareExplicación de Python asyncio: asíncrono, espera, recopilación y grupo de tareas con tiempos reales
Python asyncio se explica con el código que cronometramos: corrutinas, espera, recopilación, grupo de tareas, manejo de errores, tiempos de espera, …
Leer artículo →Desarrollo de softwareDebounce vs Throttle en JavaScript: cómo funcionan, cuándo usar cada uno, probado
Antirrebote versus aceleración en JavaScript explicado con tiempos que medimos en Node.js: cómo funciona cada uno, implementaciones simples, llamada…
Leer artículo →Desarrollo de softwareExplicación de los administradores de contexto de Python: declaración with, contextlib y usos reales
Los administradores de contexto de Python explicaron con el código que ejecutamos: cómo funciona, __enter__ y __exit__, contextlib.contextmanager, s…
Leer artículo →Inteligencia artificialLLM Temperature y Top-p explicados: cómo los modelos de IA eligen su siguiente palabra
La temperatura de LLM y top-p se explican con una simulación que ejecutamos: cómo se remodelan las probabilidades, qué mantiene topp, configuracione…
Leer artículo →DevOpsYAML explicado: sintaxis, el problema de Noruega y otras trampas que probamos
YAML explicó con una prueba de analizador: sintaxis básica, listas y mapas, el problema de Noruega, versiones que se convierten en flotantes, código…
Leer artículo →DevOpsCron Jobs explicados: sintaxis, cronogramas reales y los errores que los rompen
Los trabajos cron explicados con cronogramas que verificamos: los cinco campos, operadores, ejemplos reales, la trampa del día del mes O del día de …
Leer artículo →Inteligencia artificialExplicación de las alucinaciones de la IA: por qué los modelos de lenguaje inventan cosas y cómo reducirlas
Se explicaron las alucinaciones de la IA: qué son, por qué los modelos de lenguaje las producen, tipos comunes, cómo reducirlas con conexión a tierr…
Leer artículo →DevOpsExplicación de las variables de entorno: archivos .env, secretos y configuración bien hechos
Variables de entorno explicadas con ejemplos de Python que ejecutamos: leerlas y configurarlas, por qué cada valor es una cadena, archivos .env, her…
Leer artículo →Desarrollo de softwareExplicación de la limitación de velocidad de API: algoritmos, encabezados y manejo de errores 429
La limitación de la tasa de API se explica con una simulación que ejecutamos: depósito de tokens, ventana fija, ventana deslizante, 429 respuestas, …
Leer artículo →Automatización de pruebasBurlarse en Python: unittest.mock, patch y los errores que hacen que las pruebas mientan
Burlarse en Python con unittest.mock, probado: Mock y return_value, side_effect, parches donde se usa un nombre, especificación y autospec, fechas d…
Leer artículo →Pruebas de softwareExplicación de la cobertura del código: cobertura de línea versus sucursal y lo que realmente significa 100%
Cobertura del código explicada con una ejecución real de cobertura.py: cobertura de línea, rama y condición, lectura de un informe, por qué una cobe…
Leer artículo →Bases de datos y SQLDELETE vs TRUNCATE vs DROP en SQL: diferencias, reversión y cuándo usar cada uno
DELETE vs TRUNCATE vs DROP explicado con SQL probado: qué elimina cada uno, reversión, activadores, restablecimiento de identidad, velocidad y en qu…
Leer artículo →Bases de datos y SQLVistas SQL explicadas: cree, use y evite los errores, con ejemplos
Vistas SQL explicadas con consultas que ejecutamos: creación de una vista, resultados en vivo, ocultación de columnas, rendimiento, vistas actualiza…
Leer artículo →Desarrollo de softwareInterfaz TypeScript versus tipo: diferencias reales, probadas con el compilador
Interfaz TypeScript versus tipo, verificado con el compilador real: qué pueden hacer ambos, qué puede hacer solo uno, fusión de declaraciones, exten…
Leer artículo →Desarrollo de softwarePython *args y **kwargs explicados: funciones flexibles con ejemplos claros
Python *args y **kwargs explicados con el código que ejecutamos: empaquetado y desempaquetado, orden de parámetros, argumentos solo de palabras clav…
Leer artículo →Desarrollo de softwareFunciones Lambda de Python: sintaxis, usos reales y cuándo no utilizarlas
Funciones lambda de Python explicadas con el código que ejecutamos: sintaxis, clasificación con clave, mapa y filtro, cierres, trampa de enlace tard…
Leer artículo →Inteligencia artificial¿Qué son los agentes de IA? Cómo funcionan, con un bucle de agente simple que puedes ejecutar
¿Qué son los agentes de IA? Una guía sencilla sobre el bucle del agente, las herramientas, la memoria y las barreras de seguridad, con un pequeño bu…
Leer artículo →DevOpsMonitoreo versus observabilidad: la verdadera diferencia, con registros, métricas y seguimientos
Explicación del monitoreo versus observabilidad: fallas conocidas y desconocidas, registros, métricas y seguimientos, un recorrido por incidentes de…
Leer artículo →DevOpsDocker Volumes versus Bind Mounts: persistir los datos del contenedor de la manera correcta
Se explican los volúmenes de Docker frente a los montajes de enlace: por qué desaparecen los datos del contenedor, volúmenes con nombre, montajes de…
Leer artículo →Automatización de pruebasTDD vs BDD: diferencias clave, una función creada en ambos sentidos y cuándo usar cada una
TDD vs BDD explicado con una característica de descuento construida en ambos sentidos: refactor rojo-verde con el código que ejecutamos, escenarios …
Leer artículo →Pruebas de softwarePruebas de Aceptación de Usuario (UAT): Proceso, Lista de Verificación y Ejemplos Reales
Explicación de las pruebas de aceptación del usuario: quién las ejecuta, en qué se diferencia del control de calidad, un proceso de siete pasos, una…
Leer artículo →Bases de datos y SQLValores NULL de SQL explicados: IS NULL, COALESCE, NULLIF y las trampas que se deben evitar
Los valores NULL de SQL se explican con las consultas que ejecutamos: lógica de tres valores, IS NULL, COALESCE, NULLIF, cómo los agregados, las uni…
Leer artículo →Bases de datos y SQLDeclaración SQL CASE WHEN: sintaxis, ejemplos reales y errores comunes
CASO SQL CUANDO se explicó con las consultas que ejecutamos: formularios simples y buscados, orden de condiciones, pivotes con SUMA, trucos COUNT, c…
Leer artículo →Desarrollo de software¿Qué es JWT? Tokens web JSON explicados con un ejemplo práctico
¿Qué es JWT? JSON Web Tokens explicó: las tres partes, un token creado y manipulado en el código que ejecutamos, JWT vs sesiones, almacenamiento, to…
Leer artículo →Desarrollo de softwareExplicación del bucle de eventos de JavaScript: pila de llamadas, microtareas y temporizadores con ejemplos
El bucle de eventos de JavaScript explicado con el código que ejecutamos: pila de llamadas, colas de tareas y microtareas, por qué setTimeout 0 no e…
Leer artículo →Desarrollo de softwareExplicación de los generadores y el rendimiento de Python: ahorre memoria con ejemplos reales
Los generadores de Python y el rendimiento se explican con el código que ejecutamos: cómo se pausan y reanudan, midieron el ahorro de memoria, canal…
Leer artículo →Inteligencia artificial¿Qué son las incrustaciones? Los vectores y la similitud del coseno se explican de forma sencilla
¿Qué son las incrustaciones? Una guía en lenguaje sencillo sobre vectores, similitud de cosenos y búsqueda semántica, con un pequeño ejemplo que eje…
Leer artículo →DevOpsImplementación azul-verde versus implementación canaria: diferencias, compensaciones y cómo elegir
Explicación de la implementación azul-verde versus canaria: cómo funciona cada uno, costo, riesgo y reversión, agrupación estable de usuarios que pr…
Leer artículo →Automatización de pruebasPruebas inestables: qué las causa y cómo solucionarlas para siempre
Pruebas inestables explicadas con demostraciones que realizamos: las causas principales, cómo confirmar y diagnosticar una, correcciones adecuadas p…
Leer artículo →Pruebas de softwarePruebas de carga frente a pruebas de estrés: diferencias, métricas y ejemplos de k6
Explicación de las pruebas de carga frente a las pruebas de estrés: qué prueba cada una, pruebas de picos y de absorción, las métricas que importan,…
Leer artículo →Pruebas de softwareCaso de prueba frente a escenario de prueba: diferencias clave, ejemplos y cuándo utilizar cada uno
Caso de prueba versus escenario de prueba explicado: definiciones claras, una tabla en paralelo, una función de restablecimiento de contraseña tomad…
Leer artículo →Bases de datos y SQLOptimización de consultas SQL: lea planes de ejecución y corrija consultas lentas, con tiempos
Optimización de consultas SQL probada en un millón de filas: lea planes de ejecución, agregue los índices correctos, corrija filtros no sargables, u…
Leer artículo →Bases de datos y SQLSQL UNION vs UNION ALL: diferencias, ejemplos y rendimiento probado
SQL UNION vs UNION ALL explicado con consultas que ejecutamos: duplicados, las reglas que siguen ambos, un error de datos real, rendimiento medido, …
Leer artículo →Desarrollo de softwareTutorial de JavaScript Fetch API: GET, POST, manejo de errores y tiempos de espera
Un tutorial de JavaScript Fetch API probado en un servidor local: GET y POST, por qué 404 no arroja, un asistente reutilizable, cadenas de consulta,…
Leer artículo →Desarrollo de softwareManejo de archivos Python: lectura, escritura, CSV, JSON y pathlib con ejemplos
El manejo de archivos Python se explica con el código que ejecutamos: modos abiertos, lectura de archivos grandes, CSV, JSON, pathlib, archivos bina…
Leer artículo →Desarrollo de softwareClases y objetos de Python: tutorial de programación orientada a objetos con ejemplos reales
Clases y objetos de Python explicados con el código que ejecutamos: __init__, métodos, atributos de clase versus instancia, herencia, propiedades, m…
Leer artículo →Inteligencia artificial¿Qué es un modelo de lenguaje grande? Cómo funcionan los LLM, explicados sin exageraciones
¿Qué es un modelo de lenguaje grande? Los LLM explicados en lenguaje sencillo: tokens, incrustaciones, atención, entrenamiento, ventanas de temperat…
Leer artículo →DevOpsComandos de Linux para principiantes: la guía esencial de terminal con ejemplos
Comandos de Linux para principiantes, agrupados por tarea: navegación, archivos, visualización de registros, grep, canalizaciones, permisos, proceso…
Leer artículo →Automatización de pruebasSelenium vs Playwright: diferencias clave, comparación de códigos y cuál elegir
Comparación de Selenium vs Playwright: arquitectura, espera, soporte de navegador e idioma, depuración, la misma prueba en ambas herramientas, conse…
Leer artículo →Pruebas de softwarePartición de equivalencia: técnica de diseño de pruebas explicada con ejemplos resueltos
Explicación de la partición de equivalencia: cómo encontrar particiones válidas e inválidas, ejemplos prácticos para edades, contraseñas y cupones, …
Leer artículo →Pruebas de softwareSeveridad vs Prioridad en Pruebas de Software: Diferencias, Matriz y Ejemplos Reales
Explicación de gravedad versus prioridad en las pruebas de software: definiciones claras, una matriz de cuatro vías con ejemplos, escalas de niveles…
Leer artículo →Bases de datos y SQLTutorial de subconsultas SQL: tipos, subconsultas correlacionadas y EXISTENCIAS con ejemplos
Un tutorial de subconsultas SQL con consultas que ejecutamos: subconsultas escalares, IN, FROM y SELECT, subconsultas correlacionadas, EXISTS, la tr…
Leer artículo →Bases de datos y SQLTransacciones SQL y ACID explicados: COMMIT, ROLLBACK y niveles de aislamiento
Transacciones SQL y ACID explicadas con una transferencia bancaria que ejecutamos: COMMIT, ROLLBACK, puntos de guardado, bloqueos, niveles de aislam…
Leer artículo →Desarrollo de softwareHoja de trucos de comandos de Git: los comandos que realmente usas, con ejemplos
Una hoja de referencia de comandos de Git agrupada por tarea: configuración, preparación, ramas, controles remotos, almacenamiento, historial y desh…
Leer artículo →Desarrollo de softwareExplicación de las promesas de JavaScript: luego, captura, Promise.all y errores comunes
Las promesas de JavaScript se explican con el código que ejecutamos: estados, luego y cadenas de captura, manejo de errores, Promise.all, allSettled…
Leer artículo →Desarrollo de softwareTutorial del diccionario Python: métodos, ejemplos y patrones comunes
Un tutorial de diccionario de Python con el código que ejecutamos: crear, leer y actualizar dictados, métodos clave, fusión, comprensión, patrones d…
Leer artículo →Inteligencia artificial¿Qué es el RAG? Generación de recuperación aumentada explicada con un ejemplo práctico
¿Qué es RAG? Generación de recuperación aumentada explicada paso a paso: indexación, fragmentación, incrustaciones, recuperación, un pequeño ejemplo…
Leer artículo →DevOpsTutorial de Terraform para principiantes: infraestructura como código desde el primer archivo hasta los módulos
Un tutorial de Terraform para principiantes: comience sin una cuenta en la nube, aprenda init, planifique y aplique, luego variables, resultados, es…
Leer artículo →DevOpsDocker vs Kubernetes: diferencias clave, cómo funcionan juntos y cuál necesita
Docker vs Kubernetes explicó: qué hace cada uno, la misma aplicación se ejecuta con ambos, se comparan Docker Compose y Swarm, los Dockershim cambia…
Leer artículo →Automatización de pruebasTutorial de Pytest para principiantes: accesorios, parametrización y ejemplos reales
Un tutorial de pytest para principiantes con pruebas que ejecutamos en pytest 9.2: afirmaciones, accesorios, parametrización, conftest, marcadores, …
Leer artículo →Pruebas de softwareCiclo de vida de pruebas de software (STLC): 6 fases, criterios de entrada y salida, ejemplo
Se explicó el ciclo de vida de las pruebas de software: seis fases de STLC con criterios de entrada y salida, entregables, un ejemplo de función de …
Leer artículo →Desarrollo de softwareGit merge vs rebase: diferencias, ejemplos y cuándo usar cada uno
Git merge vs rebase explicado con salida real del log, una tabla comparativa, la regla de oro del rebase y un flujo de trabajo seguro para equipos.
Leer artículo →Desarrollo de softwareList comprehension en Python: sintaxis, ejemplos y cuándo evitarla
List comprehension en Python explicada: sintaxis, filtros, if-else, bucles anidados, tiempos medidos y cuándo es mejor un bucle for normal.
Leer artículo →