Saltar al contenido

Clave de idempotencia

Una clave de idempotencia identifica repeticiones de una misma solicitud. Su efecto depende del ámbito, la conservación y las reglas de la API.

También conocido comoIdempotency Key
APIs e integración

Una clave de idempotencia es un identificador elegido por el cliente con el que un servicio puede reconocer repeticiones de una misma solicitud. El objetivo es evitar que, al reintentar, se vuelva a ejecutar una acción de negocio ya realizada. El contrato de la API define su efecto concreto.

Revisar una solicitud con resultado incierto

En un portal ficticio se interrumpe la conexión después de una solicitud para crear un pedido. No está claro si el ERP ya lo ha creado. Si el servicio admite esta protección, el portal utiliza la misma clave en un reintento apropiado. Una clave nueva podría provocar otra creación.

Respetar las reglas de la API

Stripe describe reglas de idempotencia diferentes para las API v1 y v2. La cabecera Idempotency-Key es un ejemplo propio de ese proveedor. Compruebe el ámbito, la conservación y el tratamiento de los cambios en los datos de la solicitud. La misma clave no autoriza cualquier contenido nuevo ni demuestra, por sí sola, que el procesamiento haya terminado.

Fuentes

Términos relacionados

Artículos sobre el tema

Insights · APIs e integración2 minAclarar el trabajo de una interfaz antes de sustituirlaUna conexión antigua puede seguir soportando procesos importantes. Su sustitución exige claridad sobre efectos, excepciones y operaciones abiertas.Tobias Krüger13 nov 2026
Insights · APIs e integración2 minUna integración necesita responsables después de su puesta en marchaUna conexión en servicio necesita decisiones sobre cambios e incidencias. La instalación técnica por sí sola no asigna esa responsabilidad.Daniel Hartmann13 nov 2026
Insights · APIs e integración2 minEl esfuerzo de integración depende del recorrido de los datosDos herramientas con API pueden exigir preparativos distintos. Lo decisivo son los datos, las operaciones y los permisos necesarios.Tobias Krüger13 nov 2026
Insights · APIs e integración2 minUn modelo de datos común necesita un significado acordadoUn mismo campo puede significar cosas distintas en CRM y ERP. Los equipos deben aclarar su significado antes de definir una estructura común.Tobias Krüger13 nov 2026
Insights · APIs e integración2 minLas integraciones webhook necesitan reglas para las repeticionesEl efecto de los webhooks repetidos debe controlarse. Un acuse de recibo perdido no debe provocar otro pedido sin comprobación.Tobias Krüger13 nov 2026
Insights · APIs e integración3 minLas correspondencias de clientes dudosas necesitan un proceso claroReenviar no aclara una correspondencia de cliente incierta. La integración necesita un camino trazable desde la aclaración hasta un resultado confirmado.Tobias Krüger13 nov 2026
Insights · APIs e integración2 minLa sincronización bidireccional exige reglas de escrituraSi CRM y ERP pueden escribir, cada campo compartido necesita una regla de conflicto. El último mensaje recibido no es necesariamente la última decisión de negocio.Tobias Krüger13 nov 2026
Insights · APIs e integración2 minUna solicitud aceptada necesita un resultado visibleEn trabajos en segundo plano, el portal debe mostrar la aceptación y el desenlace. Una consulta de estado correcta puede informar de un fallo.Tobias Krüger13 nov 2026

APIs e integración con ASES

ERP, CRM y tienda bien conectados

Solicitar presupuestoMás sobre APIs e integración