title: REST API - what is the proper way for sending ID on http request?
body: <p>Let's say I have this URI endpoint:</p>
  
  <pre><code>:GET /v1/permissions
  </code></pre>
  
  <p>Which select all of the permissions on version 1.</p>
  
  <p>One also can request this:</p>
  
  <pre><code>:GET /permissions
  </code></pre>
  
  <p>Which will request all permissions by the latest default version.</p>
  
  <p>Now I want to select all of the permissions from a <strong>specific</strong> user.</p>
  
  <p>I want to know what is the proper and respectable way to send the identifier of the user - in the URI endpoint OR in the http request headers OR as a GET param.</p>
  
  <p>For example:</p>
  
  <p>Method 1:</p>
  
  <pre><code>:GET /v1/groups/:id/permissions
  </code></pre>
  
  <p>Method 1.1:</p>
  
  <pre><code>:GET /v1/:id/permissions
  </code></pre>
  
  <p>Method 2:</p>
  
  <pre><code>:GET /v1/permissions,
  "If-Match": "[REPLACE_ID_HERE]" (header)
  </code></pre>
  
  <p>Method 3: </p>
  
  <pre><code>:GET /v1/permissions/?groups=REPLACE_ID_HERE
  </code></pre>
  
  <p>All of them will work.</p>
  
  <p>But which is the proper way?</p>