GitHub API Changes | GitHub Developer Guide
This content may be out of date. For the newest content, see the API posts on the GitHub Blog . All of GitHub's Docs are now in one place ! You can see Apps , REST API , and GraphQL API on GitHub Docs. An Update on the New Search API September 28, 2013 jasonrudolph We owe a big "Thank You!" to everyone that has taken the time to try out the new Search API . We :heart: every one of you. Just as we hoped, the preview period has allowed us to see how you want to use the new API, and it has given us a chance to improve the API before finalizing it.
In order to incorporate everything that we've learned, we're going to keep the Search API in preview mode for a little while longer. We have a few bugs to squash and a couple performance kinks to iron out. We're hard at work on those improvements now, and we expect to have more news in the coming weeks. In the mean time, keep the suggestions coming ! Releases API September 25, 2013 technoweenie This summer we made it easier to release your software .
Today, you can fully automate those releases via the Releases API . This API is a little different due to the binary assets. We use the Accept header for content negotiation when requesting a release asset. Pass a standard API media type to get the API representation: curl -i -H "Authorization: token TOKEN" \ -H "Accept: application/vnd.github.manifold-preview" \ "https://uploads.github.com/repos/hubot/singularity/releases/assets/123" HTTP/1.1 200 OK { "id": 123, ... } Pass "application/octet-stream" to download the binary content. curl -i -H "Authorization: token TOKEN" \ -H "Accept: application/octet-stream" \ "https://uploads.github.com/repos/hubot/singularity/releases/assets/123" HTTP/1.1 302 Found Uploads are handled by a single request to a companion "uploads.github.com" service. curl -H "Authorization: token TOKEN" \ -H "Accept: application/vnd.github.manifold-preview" \ -H "Content-Type: application/zip" \ --data-binary @build/mac/package.zip \ "https://uploads.github.com/repos/hubot/singularity/releases/123/assets?name=1.0.0-mac.zip" Preview mode The new API is available as a preview .
This gives developers a chance to provide feedback on the direction of the API before we freeze changes. We expect to lift the preview status in 30 days. As with the Search API , we'll take this opportunity to iterate quickly. Breaking changes will be announced on this developer blog without any advance warning. Once the preview period is over, we'll consider the Releases API unchangeable. At that point, it will be stable and suitable for production use.
The preview media type is "application/vnd.github.manifold-preview". Manifold is a member of the Avengers, with the ability to teleport through time and space. He's the one in the middle holding the spear. Two-Factor Authentication and the API September 3, 2013 mastahyeti As announced earlier today , GitHub.com now supports two-factor authentication (2FA) for increased security. For users with this feature enabled, GitHub.com will prompt for a 2FA code in addition to a username and password during authentication.
We've also rolled out some improvements to the API to ensure that 2FA requirements in the API are consistent with GitHub.com. Authenticating with the API For users without 2FA enabled, and for applications using the OAuth web flow for authentication, everything is business as usual. You'll continue to authenticate with the API just as you always have. (That was easy.) If you enable 2FA and use Basic Authentication to access the API, we're providing multiple options to make the flow simple and easy.
Basic Authentication and 2FA Personal Access Tokens Personal access tokens provide the simplest option for using 2FA with Basic Authentication. You can create these tokens via the tokens settings page on GitHub.com , and you can revoke them at any time. For more information about authenticating to the API with personal access tokens, be sure to check out our help article on the topic . Tightly-integrated 2FA For developers wishing to integrate GitHub 2FA directly into their application, the API's Basic Authentication now supports the ability to send the user's 2FA code , in addition to the username and password.
We're here to help We think GitHub users are going to love the additional security provided by two-factor authentication. As always, if you have any questions or feedback, let us know . We're here to help! Improvements to the Search API August 20, 2013 jasonrudolph Today we're shipping two improvements to the new Search API . More Text Match Metadata When searching for code, the API previously provided text match metadata (i.e., "highlights") for file content.
Now, you can also get this metadata for matches that occur within the file path. For example, when searching for files that have "client" in their path , the results include this match for lib/octokit/client/commits.rb : {:.json} { "name": "commits.rb", "path": "lib/octokit/client/commits.rb", "text_matches": [ { "object_url": " https://api.github.com/repositories/417862/contents/lib/octokit/client/commits.rb?ref=8d487ab06ccef463aa9f5412a56f1a2f1fa4dc88 ", "object_type": "FileContent", "property": "path", "fragment": "lib/octokit/client/commits.rb", "matches": [ { "text": "client", "indices": [ 12, 18 ] } ] } ] // ... } Better Text Match Metadata Before today, the API applied HTML entity encoding to all fragment data.
For example, imagine your search returns an issue like rails/rails#11889 : The response would include a text_matches array with the following object: {:.json} { "fragment": "undefined method 'except' for #<Array:XXX>", // ... } Inside the fragment value, we see HTML-encoded entities (e.g., < ). Since we're returning JSON (not HTML), API clients might not expect any HTML-encoded text. As of today, the API returns these fragments without this extraneous encoding. {:.json} { "fragment": "undefined method 'except' for # Array:XXX ", // ... } Preview Period We're about halfway through the preview period for the new Search API.
We appreciate everyone that has provided feedback so far. Please keep it coming ! Preview the New Search API July 19, 2013 jasonrudolph Today we're excited to announce a brand new Search API . Whether you're searching for code , repositories , issues , or users , all the query abilities of github.com are now available via the API as well. Maybe you want to find popular Tetris implementations written in Assembly . We've got you covered.
Or perhaps you're looking for new gems that are using Octokit.rb . No problem. The possibilities are endless. Highlights On github.com, we enjoy the context provided by code snippets and highlights in search results. We want API consumers to have access to that information as well. So, API requests can opt to receive those text fragments in the response . Each fragment is accompanied by numeric offsets identifying the exact location of each matching search term.
Preview period We're making this new API available today for developers to preview . We think developers are going to love it, but we want to get your feedback before we declare the Search API "final" and "unchangeable." We expect the preview period to last for roughly 60 days. As we discover opportunities to improve this new API during the preview period, we may ship changes that break clients using the preview version of the API.
We want to iterate quickly. To do so, we will announce any changes here (on the developer blog), but we will not provide any advance notice. At the end of preview period, the Search API will become an official component of GitHub API v3. At that point, the new Search API will be stable and suitable for production use. What about the old search API? The legacy search API is still available. Many existing clients depend on it, and it is not changing in any way.
While the new API offers much more functionality, the legacy search endpoints remain an official part of GitHub API v3. Take it for a spin We hope
The rest of this page is on the live site.