<div id="readability-page-1" class="page"><div><h2 id="52-resource-objects">5.2. 리소스 오브젝트 (Resource Objects)</h2>
<hr>
“리소스 오브젝트”는 자원을 나타내는 데 사용되는 JSON API에 표시됩니다.
<blockquote>
“Resource objects” appear in a JSON API document to represent resources.
</blockquote>
리소스 오브젝트는 적어도 다음 최상위 멤버가 포함되어 있어야 합니다. &lt;MUST&gt; :
<ul>
<li><code>id</code></li>
<li><code>type</code></li>
</ul>
<blockquote>
A resource object MUST contain at least the following top-level members:
<ul>
<li><code>id</code></li>
<li><code>type</code></li>
</ul>
</blockquote>
예외: 리소스 오브젝트가 클라이언트에서 고안되고, 서버에서 생성된 새로운 리소스를 나타낼 때는 <code>id</code> 멤버는 필요하지 않습니다.
<blockquote>
Exception: The <code>id</code> member is not required when the resource object originates at the client and represents a new resource to be created on the server.
</blockquote>
추가로 리소스 오브젝트는 다음 최상위 멤버 중 하나가 포함될 수도 있습니다. &lt;MAY&gt; :
<ul>
<li><code>attributes</code>: <a href="http://jsonapi.org/format/#document-resource-object-attributes">attributes object</a>는 리소스 데이터 일부를 나타냅니다.</li>
<li><code>relationships</code>: <a href="http://jsonapi.org/format/#document-resource-object-relationships">relationships object</a>는 리소스와 다른 JSON API 리소스간 관계를 표현합니다.</li>
<li><code>links</code>: <a href="http://jsonapi.org/format/#document-links">links object</a>는 리소스와 관련된 링크를 포함합니다.</li>
<li><code>meta</code>: <a href="http://jsonapi.org/format/#document-meta">meta object</a>는 속성과 관계로는 나타낼 수 없는 리소스에 대한 비표준 메타 정보를 포함합니다.</li>
</ul>
<blockquote>
In addition, a resource object MAY contain any of these top-level members:
<ul>
<li><code>attributes</code>: an <a href="http://jsonapi.org/format/#document-resource-object-attributes">attributes object</a> representing some of the resource’s data.</li>
<li><code>relationships</code>: a <a href="http://jsonapi.org/format/#document-resource-object-relationships">relationships object</a> describing relationships between the resource and other JSON API resources.</li>
<li><code>links</code>: a <a href="http://jsonapi.org/format/#document-links">links object</a> containing links related to the resource.</li>
<li><code>meta</code>: a <a href="http://jsonapi.org/format/#document-meta">meta object</a> containing non-standard meta-information about a resource that can not be represented as an attribute or relationship.</li>
</ul>
</blockquote>
여기서 아티클(즉, “articles” 타입)이 문서에 표시될 수 있습니다. 그 방법은 다음과 같습니다:
<blockquote>
Here’s how an article (i.e. a resource of type “articles”) might appear in a document:
</blockquote>
<div><pre><code>// ...
{
 "type": "articles",
 "id": "1",
 "attributes": {
 "title": "Rails is Omakase"
 },
 "relationships": {
 "author": {
 "links": {
 "self": "/articles/1/relationships/author",
 "related": "/articles/1/author"
 },
 "data": { "type": "people", "id": "9" }
 }
 }
}
 // ...
</code></pre></div></div></div>

잘 밤에 쓸데없는 생각하기...

Thomas Sungjin Kang

5.2. 리소스 오브젝트 (Resource Objects)
“리소스 오브젝트”는 자원을 나타내는 데 사용되는 JSON API에 표시됩니다.
“Resource objects” appear in a JSON API document to represent resources.
리소스 오브젝트는 적어도 다음 최상위 멤버가 포함되어 있어야 합니다. <MUST> :
id
type
A resource object MUST contain at least the following top-level members:
id
type
예외: 리소스 오브젝트가 클라이언트에서 고안되고, 서버에서 생성된 새로운 리소스를 나타낼 때는 id 멤버는 필요하지 않습니다.
Exception: The id member is not required when the resource object originates at the client and represents a new resource to be created on the server.
추가로 리소스 오브젝트는 다음 최상위 멤버 중 하나가 포함될 수도 있습니다. <MAY> :
attributes: attributes object는 리소스 데이터 일부를 나타냅니다.
relationships: relationships object는 리소스와 다른 JSON API 리소스간 관계를 표현합니다.
links: links object는 리소스와 관련된 링크를 포함합니다.
meta: meta object는 속성과 관계로는 나타낼 수 없는 리소스에 대한 비표준 메타 정보를 포함합니다.
In addition, a resource object MAY contain any of these top-level members:
attributes: an attributes object representing some of the resource’s data.
relationships: a relationships object describing relationships between the resource and other JSON API resources.
links: a links object containing links related to the resource.
meta: a meta object containing non-standard meta-information about a resource that can not be represented as an attribute or relationship.
여기서 아티클(즉, “articles” 타입)이 문서에 표시될 수 있습니다. 그 방법은 다음과 같습니다:
Here’s how an article (i.e. a resource of type “articles”) might appear in a document:
// ...
{
 "type": "articles",
 "id": "1",
 "attributes": {
 "title": "Rails is Omakase"
 },
 "relationships": {
 "author": {
 "links": {
 "self": "/articles/1/relationships/author",
 "related": "/articles/1/author"
 },
 "data": { "type": "people", "id": "9" }
 }
 }
}
 // ...

[번역] JSON API Specification v1.0 (3) - Document Structure (3)

댓글