Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
This repository was archived by the owner on Nov 1, 2017. It is now read-only.

Sync changes from upstream repository#717

Merged
hubot merged 1 commit intomasterfromupdate-1424447082
Feb 20, 2015
Merged
Show file tree
Hide file tree
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
---
kind: change
title: Breaking changes to Authorizations API responses on April 20
created_at: 2015-02-19
author_name: ptoomey3
---

A couple weeks ago we [extended the preview period][removing-authorizations-token-extended-preview] of several API changes related to managing OAuth application authorizations. Today, we're finalizing these changes. This new functionality is now stable and suitable for production use. If your application relies on any of the affected functionality (described below), be sure to **update your code before April 20** to account for these changes.

### Breaking changes coming on April 20

If your application uses any of the following APIs, then you may be affected by this change:

- The [List your authorizations][list-your-authorizations] API
- The [Get a single authorization][get-a-single-authorization] API
- The [Get-or-create an authorization for a specific app][get-or-create-an-authorization-for-a-specific-app] API (`token` is still returned for "create")
- The [Get-or-create an authorization for a specific app and fingerprint][get-or-create-an-authorization-for-a-specific-app-and-fingerprint] API (`token` is still returned for "create")
- The [Update an existing authorization][update-an-existing-authorization] API


If your application uses these APIs, we urge you to update your application as soon as possible. (Read [the December announcement][removing-authorizations-token] for more details on the changes.)

Starting today, we're offering a migration period allowing applications to opt in to these changes (as described below). On April 20, these changes will become official parts of the GitHub API v3. At that time, these changes will apply to all API consumers.

### Migration period

During the migration period, you can opt-in to these changes using the following custom media type in the `Accept` header:

application/vnd.github.mirage-preview+json

We want to make these updates as smooth as possible for everyone, and we hope that the migration period gives you flexibility to adopt these changes on your own schedule. If you have any questions or feedback, please [get in touch with us][contact]!

[removing-authorizations-token-extended-preview]: /changes/2015-02-03-removing-authorizations-token-update/
[removing-authorizations-token]: /changes/2014-12-08-removing-authorizations-token/
[list-your-authorizations]: /v3/oauth_authorizations/#list-your-authorizations
[get-a-single-authorization]: /v3/oauth_authorizations/#get-a-single-authorization
[get-or-create-an-authorization-for-a-specific-app]: /v3/oauth_authorizations/#get-or-create-an-authorization-for-a-specific-app
[get-or-create-an-authorization-for-a-specific-app-and-fingerprint]: /v3/oauth_authorizations/#get-or-create-an-authorization-for-a-specific-app-and-fingerprint
[update-an-existing-authorization]: /v3/oauth_authorizations/#update-an-existing-authorization
[contact]: https://github.com/contact?form[subject]=Removing+authorizations+token
4 changes: 2 additions & 2 deletionscontent/v3/oauth_authorizations.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -28,7 +28,7 @@ Make sure you understand how to [work with two-factor authentication](/v3/auth/#
</ul>

<p>
Please see <a href="/changes/2014-12-08-removing-authorizations-token/">the blog post</a> for full details.
We're currently offering a migration period allowing applications to opt in to the new Authorization API behavior. This functionality will apply to all API consumers beginning April 20, 2015.Please see <a href="/changes/2015-02-20-migration-period-removing-authorizations-token/">the blog post</a> for full details.
</p>

<p>
Expand All@@ -41,7 +41,7 @@ Make sure you understand how to [work with two-factor authentication](/v3/auth/#
</p>

<p>
To access the new API functionality during thepreview period, you must
To access the new API functionality during themigration period, you must
provide a custom <a href="/v3/media/">media type</a> in the
<code>Accept</code> header:
<pre>application/vnd.github.mirage-preview+json</pre>
Expand Down
2 changes: 1 addition & 1 deletioncontent/v3/versions.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -114,7 +114,7 @@ The recommendations below will help you prepare your application for the next ma
1. Authorization attribute: token
: Recommendation: This attribute will return an empty string in the majority of
the Authorizations API responses. Please see
[the deprecation blog post](/changes/2014-12-08-removing-authorizations-token/)
[the deprecation blog post](/changes/2015-02-20-migration-period-removing-authorizations-token/)
and the [Authorizations API deprecation notice](/v3/oauth_authorizations/#deprecation-notice)
for full details.

Expand Down

[8]ページ先頭

©2009-2025 Movatter.jp