Permalink
Browse files

some ideas on api v3.0

  • Loading branch information...
1 parent 11e61b3 commit 6c3a361d9329d5d970d06717f3d3c3a6f4542b23 @technoweenie technoweenie committed Nov 17, 2011
Showing with 14 additions and 2 deletions.
  1. +14 −2 content/v3/changelog.md
View
@@ -4,8 +4,9 @@ title: GitHub API Changelog
# Current Version
-The GitHub API version is currently in beta. The Accept mime type is
-`application/vnd.github.beta+json`. The `beta` mime type property will
+ Accept: application/vnd.github.beta+json
+
+The GitHub API version is currently in beta. The `beta` mime type property will
be valid until sometime in 2012. A notice will be given closer to the
actual date.
@@ -14,10 +15,21 @@ issue](https://github.com/contact) if you have problems.
## Upcoming Version
+ Accept: application/vnd.github.v3+json
+
The API is expected to be finalized in late 2011.
### Expected Changes
+* All `*_url` attributes move to a `_links` object. See [Pull
+ Requests](http://developer.github.com/v3/pulls/#get-a-single-pull-request) for an example.
+* The `/repos/:user/:repo/hooks/:id/test` action becomes
+ `/repos/:user/:repo/hooks/:id/tests`.
+* The `/gists/:id/fork` action becomes `/gists/:id/forks`.
+* Gist forks/history objects become separate API calls.
+* Gist files object is not returned on Gist listings.
+* Commit schema will change to be more consistent.
+* `master_branch` becomes `default_branch`.
* `integrate_branch` on the [repo API](/v3/repos/#get) will no longer be
returned.

0 comments on commit 6c3a361

Please sign in to comment.