title: Confusion Between Noun vs. Verb in Rest URLs
body: <p>I have studied over the internet about restful APIs that it focuses on nouns not verbs in the url pattern, but now I am seeing multiple links that use verbs in the URL. </p>
  
  <p>Here is an example.</p>
  
  <blockquote>
    <ul>
    <li>POST /v1/payments/authorization/&lt;Authorization-Id&gt;/capture</li>
    <li>POST /v1/payments/authorization/&lt;Authorization-Id&gt;/void</li>
    <li>POST /v1/payments/authorization/&lt;Authorization-Id&gt;/reauthorize</li>
    </ul>
  </blockquote>
  
  <p>this is Paypal apis. <a href="https://developer.paypal.com/docs/api/#c">PayPal API</a></p>
  
  <p>also on wikipedia on HTATEOAS page they gave a example ;</p>
  
  <pre><code>&lt;?xml version="1.0"?&gt;
  &lt;account&gt;
     &lt;account_number&gt;12345&lt;/account_number&gt;
     &lt;balance currency="usd"&gt;100.00&lt;/balance&gt;
     &lt;link rel="deposit" href="/account/12345/deposit" /&gt;
     &lt;link rel="withdraw" href="/account/12345/withdraw" /&gt; 
     &lt;link rel="transfer" href="/account/12345/transfer" /&gt;
     &lt;link rel="close" href="/account/12345/close" /&gt;
   &lt;/account&gt;
  </code></pre>
  
  <p>link:  Wiki <a href="http://en.wikipedia.org/wiki/HATEOAS">HATEOAS</a></p>
  
  <p>Can anyone help me get some clarity about this? why 'capture', 'void', 'deposit', 'withdraw', 'close' are in the URI cause they are all verbs not nouns?</p>
  
  <p>or is this okay to use these kind of words in rest-full apis url?</p>