title: Warning client about deprecated REST API
body: <p>We are deprecating the REST service and we want to inform the client about this. what is the best practice followed?</p>
  
  <p>I can think of following options </p>
  
  <ol>
  <li>Pass the deprecation warning message as part of service response JSON/XML</li>
  <li>Pass the warning message in HTTP “Warning” Response header.</li>
  </ol>
  
  <p>Could you please share your ideas?</p>