Se stai aggiornando una variabile in un'API RESTful, ad esempio person 's weight , come dovrebbe essere disposto?
Quello che ho pensato:
/person/1/weight?weight=150
PUT /person/1/weight
{"weight": 150}
PUT /person/1/weight
150
Ci sono state alcune risposte su questo argomento, ma non mi sembra che le sia stato risposto in modo chiaro e solido.
Poiché stai aggiornando solo parte della risorsa dovresti prendere in considerazione l'utilizzo del metodo HTTP PATCH .
Il formato della richiesta dipende dalle altre tue chiamate API. Preferire la coerenza. Se usi JSON altrove usa JSON. Lo stesso vale per XML o qualsiasi altra lingua tu usi.
Suggerisco di utilizzare JSON, ma non so quanto sia complessa la tua API.
Fai, lo farei:
PATCH person/1
Content-Type: application/json
{"weight": 150}