Método PUT / PATCH
Los métodos PUT y PATCH se utilizan para modificar un recurso. La diferencia entre ambos es que el método PUT impacta sobre la totalidad de los atributos del recurso y el método PATCH lo hace sobre uno o varios de esos atributos.
•Usan los verbos HTTP PUT y PATCH respectivamente.
•La url contiene el nombre de colección y la identificación del recurso que se va a modificar.
•Los nuevos valores de los atributos del recurso se especifican en el cuerpo de la solicitud, es decir, la configuración declara una cláusula "body".
En el caso del PUT se deben especificar todos los valores para todos los atributos del recurso. En cambio, en el caso del PATCH, solo deben especificarse los valores de los atributos que desean modificarse.
•No cuenta con cuerpo de la respuesta.
•Se debe especificar la fecha de modificación (dtLastUpdate) obtenida con una consulta (GET) a la instancia correspondiente previo a realizar la modificación.
Ejemplo: Modificación de la instancia con Id = 93 del formulario "Account".
PUT /forms/CRM_ACCOUNT/instances/93
El cuerpo de la solicitud (cláusula "body") contiene:
{ "cbIsPartner": false, "cdInstanceOwner": "JPerez", "cdStatus": "Activa", "cdType": "1", "dsCompany": "Tenaris", "dsDescription": "", "dsHolding": "TECHINT", "dsIndustry": "4", "dsOwner": "Juan Perez", "dsSource": "Referido", "dtLastUpdate":"1575059822000", "dtOpening": "1540782000000", "emails":"", "flLogo": null, "idPartnerCompany": null, "nuIdentifNumber": "30-00000000-5", "qtAnualRev": "1500000000", "qtEmployee": 1000, "qtScore": 90, "lsAddress": [ { "lsAddress/dsAddress": "Della Paolera 333", "lsAddress/dsCity": "buenos aires", "lsAddress/dsCountry": "argentina", "lsAddress/dsState": "buenos aires", "lsAddress/tpAddress": "1" } ], "lsFiles": [ { "lsFiles/dsFile": null, "_nuSequence": 0 } ], "webSiteLine": [ { "webSiteLine/dsWebsite": "www.tenaris.com", "webSiteLine/tpWebsite": "1" } ], "phoneLine": [ { "phoneLine/tpPhone": "1", "phoneLine/nrPhone": "01137489236" } ], "eMailLine": [ { "eMailLine/tpEmail": "1", "eMailLine/dsEmail": "info@tenaris.com" } ] } |
PATCH /forms/CRMACCOUNT/instances/93
El cuerpo de la solicitud (cláusula "body") contiene:
{ "dsDescription": "Empresa de acero", "dsHolding": "TECHINT Co", "dsIndustry": "4" , "dtLastUpdate":"1687549970000" } |
