{"action":"created","comment":{"url":"https://api.github.com/repos/json-api/json-api/pulls/comments/32285202","id":32285202,"diff_hunk":"@@ -0,0 +1,357 @@\n+{\n+  \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n+  \"title\": \"JSON API Schema\",\n+  \"description\": \"This is a schema for responses in the JSON API format. For more, see http://jsonapi.org\",\n+  \"oneOf\": [\n+    {\n+      \"$ref\": \"#/definitions/success\"\n+    },\n+    {\n+      \"$ref\": \"#/definitions/failure\"\n+    },\n+    {\n+      \"$ref\": \"#/definitions/info\"\n+    }\n+  ],\n+  \n+  \"definitions\": {\n+    \"success\": {\n+      \"type\": \"object\",\n+      \"required\": [\n+        \"data\"\n+      ],\n+      \"properties\": {\n+        \"data\": {\n+          \"$ref\": \"#/definitions/data\"\n+        },\n+        \"included\": {\n+          \"description\": \"To reduce the number of HTTP requests, servers **MAY** allow responses that include related resources along with the requested primary resources. Such responses are called \\\"compound documents\\\".\",\n+          \"type\": \"array\",\n+          \"items\": {\n+            \"$ref\": \"#/definitions/resource\"\n+          },\n+          \"uniqueItems\": true\n+        },\n+        \"meta\": {\n+          \"$ref\": \"#/definitions/meta\"\n+        },\n+        \"links\": {\n+          \"description\": \"Link members related to the primary data.\",\n+          \"allOf\": [\n+            {\n+              \"$ref\": \"#/definitions/links\"\n+            },\n+            {\n+              \"$ref\": \"#/definitions/pagination\"\n+            }\n+          ]\n+        },\n+        \"jsonapi\": {\n+          \"$ref\": \"#/definitions/jsonapi\"\n+        }\n+      },\n+\t\t\t\"additionalProperties\": false\n+    },\n+    \"failure\": {\n+      \"type\": \"object\",\n+      \"required\": [\n+        \"errors\"\n+      ],\n+      \"properties\": {\n+        \"errors\": {\n+          \"type\": \"array\",\n+          \"items\": {\n+            \"$ref\": \"#/definitions/error\"\n+          },\n+          \"uniqueItems\": true\n+        },\n+        \"meta\": {\n+          \"$ref\": \"#/definitions/meta\"\n+        },\n+        \"jsonapi\": {\n+          \"$ref\": \"#/definitions/jsonapi\"\n+        }\n+      },\n+      \"additionalProperties\": false\n+    },\n+    \"info\": {\n+      \"type\": \"object\",\n+      \"required\": [\n+        \"meta\"\n+      ],\n+      \"properties\": {\n+        \"meta\": {\n+          \"$ref\": \"#/definitions/meta\"\n+        },\n+        \"links\": {\n+\t\t\t\t\t\"$ref\": \"#/definitions/links\"\n+        },\n+        \"jsonapi\": {\n+          \"$ref\": \"#/definitions/jsonapi\"\n+        }\n+\t\t\t},\n+\t\t\t\"additionalProperties\": false\n+    },\n+    \n+    \"meta\": {\n+      \"description\": \"Non-standard meta-information that can not be represented as an attribute or relationship.\",\n+      \"type\": \"object\",\n+      \"additionalProperties\": true\n+    },\n+    \"data\": {\n+      \"description\": \"The document's \\\"primary data\\\" is a representation of the resource or collection of resources targeted by a request.\",\n+      \"oneOf\": [\n+        {\n+          \"$ref\": \"#/definitions/resource\"\n+        },\n+        {\n+          \"description\": \"An array of resource objects, an array of resource identifier objects, or an empty array ([]), for requests that target resource collections.\",\n+          \"type\": \"array\",\n+          \"items\": {\n+            \"$ref\": \"#/definitions/resource\"\n+          },\n+          \"uniqueItems\": true\n+        }","path":"schema","position":114,"original_position":114,"commit_id":"0357d5b1233886a937f5d4b2ff4931ab83c05e9b","original_commit_id":"05734e31a28f0778c864b9fb0eaa470975db3e32","user":{"login":"eneuhauser","id":1237486,"avatar_url":"https://avatars.githubusercontent.com/u/1237486?v=3","gravatar_id":"","url":"https://api.github.com/users/eneuhauser","html_url":"https://github.com/eneuhauser","followers_url":"https://api.github.com/users/eneuhauser/followers","following_url":"https://api.github.com/users/eneuhauser/following{/other_user}","gists_url":"https://api.github.com/users/eneuhauser/gists{/gist_id}","starred_url":"https://api.github.com/users/eneuhauser/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eneuhauser/subscriptions","organizations_url":"https://api.github.com/users/eneuhauser/orgs","repos_url":"https://api.github.com/users/eneuhauser/repos","events_url":"https://api.github.com/users/eneuhauser/events{/privacy}","received_events_url":"https://api.github.com/users/eneuhauser/received_events","type":"User","site_admin":false},"body":"I don't know about this one. You wouldn't create a new object to represent an array of resources, so I don't think it needs its own definition.","created_at":"2015-06-12T01:42:21Z","updated_at":"2015-06-12T01:42:21Z","html_url":"https://github.com/json-api/json-api/pull/440#discussion_r32285202","pull_request_url":"https://api.github.com/repos/json-api/json-api/pulls/440","_links":{"self":{"href":"https://api.github.com/repos/json-api/json-api/pulls/comments/32285202"},"html":{"href":"https://github.com/json-api/json-api/pull/440#discussion_r32285202"},"pull_request":{"href":"https://api.github.com/repos/json-api/json-api/pulls/440"}}},"pull_request":{"url":"https://api.github.com/repos/json-api/json-api/pulls/440","id":30820003,"html_url":"https://github.com/json-api/json-api/pull/440","diff_url":"https://github.com/json-api/json-api/pull/440.diff","patch_url":"https://github.com/json-api/json-api/pull/440.patch","issue_url":"https://api.github.com/repos/json-api/json-api/issues/440","number":440,"state":"open","locked":false,"title":"Adding a detailed json-schema","user":{"login":"eneuhauser","id":1237486,"avatar_url":"https://avatars.githubusercontent.com/u/1237486?v=3","gravatar_id":"","url":"https://api.github.com/users/eneuhauser","html_url":"https://github.com/eneuhauser","followers_url":"https://api.github.com/users/eneuhauser/followers","following_url":"https://api.github.com/users/eneuhauser/following{/other_user}","gists_url":"https://api.github.com/users/eneuhauser/gists{/gist_id}","starred_url":"https://api.github.com/users/eneuhauser/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eneuhauser/subscriptions","organizations_url":"https://api.github.com/users/eneuhauser/orgs","repos_url":"https://api.github.com/users/eneuhauser/repos","events_url":"https://api.github.com/users/eneuhauser/events{/privacy}","received_events_url":"https://api.github.com/users/eneuhauser/received_events","type":"User","site_admin":false},"body":"I saw that you just removed the json-schema, but I believe this schema is a good representation of JSON API and concisely explains the format.","created_at":"2015-03-10T03:25:01Z","updated_at":"2015-06-12T01:42:21Z","closed_at":null,"merged_at":null,"merge_commit_sha":"284a0c6c3ce10046bca2da2f5f5a58a7c7fbabfc","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/json-api/json-api/pulls/440/commits","review_comments_url":"https://api.github.com/repos/json-api/json-api/pulls/440/comments","review_comment_url":"https://api.github.com/repos/json-api/json-api/pulls/comments{/number}","comments_url":"https://api.github.com/repos/json-api/json-api/issues/440/comments","statuses_url":"https://api.github.com/repos/json-api/json-api/statuses/0357d5b1233886a937f5d4b2ff4931ab83c05e9b","head":{"label":"eneuhauser:schema","ref":"schema","sha":"0357d5b1233886a937f5d4b2ff4931ab83c05e9b","user":{"login":"eneuhauser","id":1237486,"avatar_url":"https://avatars.githubusercontent.com/u/1237486?v=3","gravatar_id":"","url":"https://api.github.com/users/eneuhauser","html_url":"https://github.com/eneuhauser","followers_url":"https://api.github.com/users/eneuhauser/followers","following_url":"https://api.github.com/users/eneuhauser/following{/other_user}","gists_url":"https://api.github.com/users/eneuhauser/gists{/gist_id}","starred_url":"https://api.github.com/users/eneuhauser/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eneuhauser/subscriptions","organizations_url":"https://api.github.com/users/eneuhauser/orgs","repos_url":"https://api.github.com/users/eneuhauser/repos","events_url":"https://api.github.com/users/eneuhauser/events{/privacy}","received_events_url":"https://api.github.com/users/eneuhauser/received_events","type":"User","site_admin":false},"repo":{"id":31923107,"name":"json-api","full_name":"eneuhauser/json-api","owner":{"login":"eneuhauser","id":1237486,"avatar_url":"https://avatars.githubusercontent.com/u/1237486?v=3","gravatar_id":"","url":"https://api.github.com/users/eneuhauser","html_url":"https://github.com/eneuhauser","followers_url":"https://api.github.com/users/eneuhauser/followers","following_url":"https://api.github.com/users/eneuhauser/following{/other_user}","gists_url":"https://api.github.com/users/eneuhauser/gists{/gist_id}","starred_url":"https://api.github.com/users/eneuhauser/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eneuhauser/subscriptions","organizations_url":"https://api.github.com/users/eneuhauser/orgs","repos_url":"https://api.github.com/users/eneuhauser/repos","events_url":"https://api.github.com/users/eneuhauser/events{/privacy}","received_events_url":"https://api.github.com/users/eneuhauser/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/eneuhauser/json-api","description":"A shared media type for JSON APIs.","fork":true,"url":"https://api.github.com/repos/eneuhauser/json-api","forks_url":"https://api.github.com/repos/eneuhauser/json-api/forks","keys_url":"https://api.github.com/repos/eneuhauser/json-api/keys{/key_id}","collaborators_url":"https://api.github.com/repos/eneuhauser/json-api/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/eneuhauser/json-api/teams","hooks_url":"https://api.github.com/repos/eneuhauser/json-api/hooks","issue_events_url":"https://api.github.com/repos/eneuhauser/json-api/issues/events{/number}","events_url":"https://api.github.com/repos/eneuhauser/json-api/events","assignees_url":"https://api.github.com/repos/eneuhauser/json-api/assignees{/user}","branches_url":"https://api.github.com/repos/eneuhauser/json-api/branches{/branch}","tags_url":"https://api.github.com/repos/eneuhauser/json-api/tags","blobs_url":"https://api.github.com/repos/eneuhauser/json-api/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/eneuhauser/json-api/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/eneuhauser/json-api/git/refs{/sha}","trees_url":"https://api.github.com/repos/eneuhauser/json-api/git/trees{/sha}","statuses_url":"https://api.github.com/repos/eneuhauser/json-api/statuses/{sha}","languages_url":"https://api.github.com/repos/eneuhauser/json-api/languages","stargazers_url":"https://api.github.com/repos/eneuhauser/json-api/stargazers","contributors_url":"https://api.github.com/repos/eneuhauser/json-api/contributors","subscribers_url":"https://api.github.com/repos/eneuhauser/json-api/subscribers","subscription_url":"https://api.github.com/repos/eneuhauser/json-api/subscription","commits_url":"https://api.github.com/repos/eneuhauser/json-api/commits{/sha}","git_commits_url":"https://api.github.com/repos/eneuhauser/json-api/git/commits{/sha}","comments_url":"https://api.github.com/repos/eneuhauser/json-api/comments{/number}","issue_comment_url":"https://api.github.com/repos/eneuhauser/json-api/issues/comments{/number}","contents_url":"https://api.github.com/repos/eneuhauser/json-api/contents/{+path}","compare_url":"https://api.github.com/repos/eneuhauser/json-api/compare/{base}...{head}","merges_url":"https://api.github.com/repos/eneuhauser/json-api/merges","archive_url":"https://api.github.com/repos/eneuhauser/json-api/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/eneuhauser/json-api/downloads","issues_url":"https://api.github.com/repos/eneuhauser/json-api/issues{/number}","pulls_url":"https://api.github.com/repos/eneuhauser/json-api/pulls{/number}","milestones_url":"https://api.github.com/repos/eneuhauser/json-api/milestones{/number}","notifications_url":"https://api.github.com/repos/eneuhauser/json-api/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/eneuhauser/json-api/labels{/name}","releases_url":"https://api.github.com/repos/eneuhauser/json-api/releases{/id}","created_at":"2015-03-09T21:15:51Z","updated_at":"2015-03-16T14:03:45Z","pushed_at":"2015-06-12T01:38:53Z","git_url":"git://github.com/eneuhauser/json-api.git","ssh_url":"git@github.com:eneuhauser/json-api.git","clone_url":"https://github.com/eneuhauser/json-api.git","svn_url":"https://github.com/eneuhauser/json-api","homepage":"http://jsonapi.org","size":764,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"gh-pages"}},"base":{"label":"json-api:gh-pages","ref":"gh-pages","sha":"313a9e1f4269794bac3b06becf7427ae6886485b","user":{"login":"json-api","id":4341694,"avatar_url":"https://avatars.githubusercontent.com/u/4341694?v=3","gravatar_id":"","url":"https://api.github.com/users/json-api","html_url":"https://github.com/json-api","followers_url":"https://api.github.com/users/json-api/followers","following_url":"https://api.github.com/users/json-api/following{/other_user}","gists_url":"https://api.github.com/users/json-api/gists{/gist_id}","starred_url":"https://api.github.com/users/json-api/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/json-api/subscriptions","organizations_url":"https://api.github.com/users/json-api/orgs","repos_url":"https://api.github.com/users/json-api/repos","events_url":"https://api.github.com/users/json-api/events{/privacy}","received_events_url":"https://api.github.com/users/json-api/received_events","type":"Organization","site_admin":false},"repo":{"id":9859154,"name":"json-api","full_name":"json-api/json-api","owner":{"login":"json-api","id":4341694,"avatar_url":"https://avatars.githubusercontent.com/u/4341694?v=3","gravatar_id":"","url":"https://api.github.com/users/json-api","html_url":"https://github.com/json-api","followers_url":"https://api.github.com/users/json-api/followers","following_url":"https://api.github.com/users/json-api/following{/other_user}","gists_url":"https://api.github.com/users/json-api/gists{/gist_id}","starred_url":"https://api.github.com/users/json-api/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/json-api/subscriptions","organizations_url":"https://api.github.com/users/json-api/orgs","repos_url":"https://api.github.com/users/json-api/repos","events_url":"https://api.github.com/users/json-api/events{/privacy}","received_events_url":"https://api.github.com/users/json-api/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/json-api/json-api","description":"A specification for building JSON APIs","fork":false,"url":"https://api.github.com/repos/json-api/json-api","forks_url":"https://api.github.com/repos/json-api/json-api/forks","keys_url":"https://api.github.com/repos/json-api/json-api/keys{/key_id}","collaborators_url":"https://api.github.com/repos/json-api/json-api/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/json-api/json-api/teams","hooks_url":"https://api.github.com/repos/json-api/json-api/hooks","issue_events_url":"https://api.github.com/repos/json-api/json-api/issues/events{/number}","events_url":"https://api.github.com/repos/json-api/json-api/events","assignees_url":"https://api.github.com/repos/json-api/json-api/assignees{/user}","branches_url":"https://api.github.com/repos/json-api/json-api/branches{/branch}","tags_url":"https://api.github.com/repos/json-api/json-api/tags","blobs_url":"https://api.github.com/repos/json-api/json-api/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/json-api/json-api/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/json-api/json-api/git/refs{/sha}","trees_url":"https://api.github.com/repos/json-api/json-api/git/trees{/sha}","statuses_url":"https://api.github.com/repos/json-api/json-api/statuses/{sha}","languages_url":"https://api.github.com/repos/json-api/json-api/languages","stargazers_url":"https://api.github.com/repos/json-api/json-api/stargazers","contributors_url":"https://api.github.com/repos/json-api/json-api/contributors","subscribers_url":"https://api.github.com/repos/json-api/json-api/subscribers","subscription_url":"https://api.github.com/repos/json-api/json-api/subscription","commits_url":"https://api.github.com/repos/json-api/json-api/commits{/sha}","git_commits_url":"https://api.github.com/repos/json-api/json-api/git/commits{/sha}","comments_url":"https://api.github.com/repos/json-api/json-api/comments{/number}","issue_comment_url":"https://api.github.com/repos/json-api/json-api/issues/comments{/number}","contents_url":"https://api.github.com/repos/json-api/json-api/contents/{+path}","compare_url":"https://api.github.com/repos/json-api/json-api/compare/{base}...{head}","merges_url":"https://api.github.com/repos/json-api/json-api/merges","archive_url":"https://api.github.com/repos/json-api/json-api/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/json-api/json-api/downloads","issues_url":"https://api.github.com/repos/json-api/json-api/issues{/number}","pulls_url":"https://api.github.com/repos/json-api/json-api/pulls{/number}","milestones_url":"https://api.github.com/repos/json-api/json-api/milestones{/number}","notifications_url":"https://api.github.com/repos/json-api/json-api/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/json-api/json-api/labels{/name}","releases_url":"https://api.github.com/repos/json-api/json-api/releases{/id}","created_at":"2013-05-04T19:29:30Z","updated_at":"2015-06-11T20:42:57Z","pushed_at":"2015-06-12T01:38:54Z","git_url":"git://github.com/json-api/json-api.git","ssh_url":"git@github.com:json-api/json-api.git","clone_url":"https://github.com/json-api/json-api.git","svn_url":"https://github.com/json-api/json-api","homepage":"http://jsonapi.org","size":4563,"stargazers_count":2425,"watchers_count":2425,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":281,"mirror_url":null,"open_issues_count":81,"forks":281,"open_issues":81,"watchers":2425,"default_branch":"gh-pages"}},"_links":{"self":{"href":"https://api.github.com/repos/json-api/json-api/pulls/440"},"html":{"href":"https://github.com/json-api/json-api/pull/440"},"issue":{"href":"https://api.github.com/repos/json-api/json-api/issues/440"},"comments":{"href":"https://api.github.com/repos/json-api/json-api/issues/440/comments"},"review_comments":{"href":"https://api.github.com/repos/json-api/json-api/pulls/440/comments"},"review_comment":{"href":"https://api.github.com/repos/json-api/json-api/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/json-api/json-api/pulls/440/commits"},"statuses":{"href":"https://api.github.com/repos/json-api/json-api/statuses/0357d5b1233886a937f5d4b2ff4931ab83c05e9b"}}}}