Actualizaciones (JSON Patch)
Modifica recursos con PATCH y un cuerpo en formato JSON Patch (RFC 6902).
Para modificar un recurso existente usas PATCH con un cuerpo en formato
JSON Patch (RFC 6902): un
arreglo de operaciones, cada una con op, path y (según la operación)
value. Se envía con Content-Type: application/json.
curl -X PATCH 'https://mx.stage.app.mendel.com/api/public/v1/purchases/{code}' \
-H 'X-API-KEY: tu_api_key_aqui' \
-H 'Content-Type: application/json' \
-d '[
{ "op": "replace", "path": "/costCenterCode", "value": "0590843e-1d92-4d51-82c6-4a22a6b8be82" }
]'Operaciones
Cada elemento del arreglo es una operación de JSON Patch:
op | Efecto | Campos |
|---|---|---|
replace | Reemplaza el valor de un campo existente. | path, value |
add | Agrega un valor (campo o elemento de arreglo). | path, value |
remove | Elimina un campo o elemento. | path |
El path es un JSON Pointer
(ej. /costCenterCode). Las operaciones se aplican en orden.
Qué esperar
- Un
200 OKdevuelve el recurso ya actualizado. - Los campos que no toques conservan su valor anterior.
- Consulta la Referencia de API de cada endpoint para saber qué campos son modificables — no todos lo son.
Es application/json, no application/json-patch+json
Aunque el cuerpo sigue la semántica de JSON Patch, la API lo recibe con
Content-Type: application/json. Envía el arreglo de operaciones con ese header.
Concurrencia
Si tu actualización choca con un cambio más reciente sobre el mismo recurso,
puedes recibir un 409 Conflict. En ese caso, relee el recurso y reintenta.