title: Django-Rest-Framework: How to Document GET-less Endpoint?
body: <p>My co-worker implemented an API that only allows GET requests with an ID parameter (so I can GET <code>/foo/5</code> but can't GET <code>/foo/</code>).  If I try to access the API's endpoint without providing an ID parameter, it (correctly) throws an unimplemented exception.</p>
  
  <p>I want to fix this endpoint to show its documentation when viewed, without an ID, over the web.  However, I still want it to throw an exception when that endpoint is accessed programatically.</p>
  
  <p>As I remember it, django-rest-framework is capable of distinguishing those two cases (via request headers), but I'm not sure how to define the endpoint such that it returns either documentation HTML or an exception  as appropriate.</p>
  
  <p>Can anyone help provide the pattern for this?</p>