Primeros pasos
Lectura
Lee el recurso antes de editarlo y envía expected_version según la documentación.
Escritura
Utiliza POST para crear recursos admitidos, PATCH para actualizaciones parciales y DELETE para eliminaciones admitidas.
Respuesta
La repetición de una operación correcta devuelve su resultado almacenado sin aplicar de nuevo el cambio.
Cabeceras
- Idempotency-Key
- Toda escritura de recursos exige Idempotency-Key. Genera una clave por operación lógica; conserva la misma clave, método, destino y contenido al reintentar esa operación.
- expected_version
- Los cambios de precios pueden requerir también versiones del producto, precio, precios de variantes o lista de precios. Si cambia una versión, vuelve a leer el recurso y concilia la actualización en lugar de imponer datos antiguos.
Política de reintentos
- Reutilizar una clave para otra solicitud produce idempotency.key_reused.
- Todos los ejemplos son sintéticos; sustituye los identificadores por valores obtenidos de tu propia tienda antes de ejecutarlos.