Tsumiki

<ul data-line="0" class="code-line">
<li data-line="0" class="code-line">RESTの場合、リソースを表すものとして使用する</li>
<li data-line="1" class="code-line">基本的に名詞を使用する
<ul data-line="2" class="code-line">
<li data-line="2" class="code-line">api/companies/</li>
</ul>
</li>
<li data-line="3" class="code-line">集合の中にある個々のリソースを表す場合は、集合のリソースのパスに続けて識別する値を含める
<ul data-line="4" class="code-line">
<li data-line="4" class="code-line">api/companies/{id}</li>
</ul>
</li>
<li data-line="5" class="code-line">親リソースを子リソースのパスに含めるかは、ケースバイケース
<ul data-line="6" class="code-line">
<li data-line="6" class="code-line">api/companies/{id}/persons/{id}</li>
<li data-line="7" class="code-line">api/persons/{id}</li>
</ul>
</li>
<li data-line="8" class="code-line">個別の属性としてリソースを表すか、属性をグループ化して構造化された形で表すかは、ケースバイケース
<ul data-line="9" class="code-line">
<li data-line="9" class="code-line">api/companies/address</li>
<li data-line="10" class="code-line">api/companies/phone</li>
<li data-line="11" class="code-line">api/companies/email</li>
<li data-line="12" class="code-line">or</li>
<li data-line="13" class="code-line">api/companies/contacts/address</li>
<li data-line="14" class="code-line">api/companies/contacts/phone</li>
<li data-line="15" class="code-line">api/companies/contacts/email</li>
</ul>
</li>
<li data-line="16" class="code-line">リソースで表すのが困難な場合、動詞を使用して操作を表すパスとすることもあるが、安易には使用しない
<ul data-line="17" class="code-line">
<li data-line="17" class="code-line">api/signup</li>
</ul>
</li>
</ul>
