Avviso client sull'API REST deprecato

Question

Stiamo ritirando il servizio REST e vogliamo informare il cliente su questo. qual è la migliore pratica seguita?

mi viene in mente seguenti opzioni

1. Far passare il messaggio di avviso deprecazione come parte della risposta del servizio JSON/XML
2. passare il messaggio di avviso in HTTP “Warning” intestazione di risposta.

Potresti condividere le tue idee?

Answer 1

Non cambierei nulla nel codice di stato o nella risposta del servizio per essere compatibile con le versioni precedenti. Aggiungerei un'intestazione "Avvertenza" nella risposta.

Warning: 299 - "Deprecated API" 

Si potrebbe anche verificare questo (vecchio) Risposta: https://softwareengineering.stackexchange.com/questions/55081/deprecate-a-web-api-best-practices