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#757

Merged
hubot merged 1 commit intomasterfromupdate-1429553191
Apr 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,38 @@
---
kind: change
title: Authorizations API response changes are now in effect
created_at: 2015-04-20
author_name: ptoomey3
---

Two months ago, we
[announced the migration period][migration-period-announcement]
for several [API changes related to managing OAuth authorizations][original-announcement].
As promised, the migration period concluded today, and these changes are
now in effect for all requests.

### Preview media type no longer needed

If you used the updated Authorizations API during the migration period, you needed
to provide a custom media type in the `Accept` header:

application/vnd.github.mirage-preview+json

Now that the migration period has ended, you no longer need to pass this custom
media type.

Instead, we [recommend][media-types] that you specify `v3` as the version in the
`Accept` header:

application/vnd.github.v3+json

### Feedback

As always, if you have any feedback, please don't hesitate to
[get in touch with us][contact].

[migration-period-announcement]: /changes/2015-02-20-migration-period-removing-authorizations-token
[original-announcement]: /changes/2014-12-08-removing-authorizations-token/
[docs]: /v3/oauth_authorizations
[media-types]: /v3/media
[contact]: https://github.com/contact?form[subject]=Removing+token+from+Authorizations+API
27 changes: 9 additions & 18 deletionscontent/v3/oauth_authorizations.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -28,23 +28,16 @@ Make sure you understand how to [work with two-factor authentication](/v3/auth/#
</ul>

<p>
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>
In order to reduce the impact of removing the <code>token</code> attribute,
the OAuth Authorizations API has added a new request attribute
(<code>fingerprint</code>), added three new response attributes
To reduce the impact of removing the <code>token</code> value,
the OAuth Authorizations API now includes a new request attribute
(<code>fingerprint</code>), three new response attributes
(<code>token_last_eight</code>, <code>hashed_token</code>, and
<code>fingerprint</code>), and added
<a href="#get-or-create-an-authorization-for-a-specific-app-and-fingerprint">one newAPI</a>.
<code>fingerprint</code>), and
<a href="#get-or-create-an-authorization-for-a-specific-app-and-fingerprint">one newendpoint</a>.
</p>

<p>
To access the new API functionality during the migration 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>
This functionality became the default for all requests on April 20, 2015. Please see <a href="/changes/2015-04-20-authorizations-api-response-changes-are-now-in-effect/">the blog post</a> for full details.
</p>
</div>

Expand DownExpand Up@@ -87,7 +80,7 @@ Name | Type | Description
`note_url`|`string` | A URL to remind you what app the OAuth token is for.
`client_id`|`string` | The 20 character OAuth app client key for which to create the token.
`client_secret`|`string` | The 40 character OAuth app client secret for which to create the token.
`fingerprint`|`string` |**This attribute is only available when using the [mirage-preview](#deprecation-notice) media type.**A unique string to distinguish an authorization from others created for the same client ID and user.
`fingerprint`|`string` | A unique string to distinguish an authorization from others created for the same client ID and user.


<%= json :scopes => ["public_repo"], :note => 'admin script' %>
Expand DownExpand Up@@ -115,7 +108,7 @@ Name | Type | Description
`scopes`|`array` | A list of scopes that this authorization is in.
`note`|`string` | A note to remind you what the OAuth token is for.
`note_url`|`string` | A URL to remind you what app the OAuth token is for.
`fingerprint`|`string` |**This attribute is only available when using the [mirage-preview](#deprecation-notice) media type.**A unique string to distinguish an authorization from others created for the same client and user. If provided, this API is functionally equivalent to [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).
`fingerprint`|`string` | A unique string to distinguish an authorization from others created for the same client and user. If provided, this API is functionally equivalent to [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).


<%= json :client_secret => "abcdabcdabcdabcdabcdabcdabcdabcdabcdabcd", :scopes => ["public_repo"], :note => 'admin script' %>
Expand All@@ -132,8 +125,6 @@ Name | Type | Description

## Get-or-create an authorization for a specific app and fingerprint

**This API method is only available when using the
[mirage-preview](#deprecation-notice) media type.**
This method will create a new authorization for the specified OAuth application,
only if an authorization for that application and fingerprint do not already
exist for the user. The URL includes the 20 character client ID for the OAuth
Expand DownExpand Up@@ -179,7 +170,7 @@ Name | Type | Description
`remove_scopes`|`array` | A list of scopes to remove from this authorization.
`note`|`string` | A note to remind you what the OAuth token is for.
`note_url`|`string` | A URL to remind you what app the OAuth token is for.
`fingerprint`|`string` |**This attribute is only available when using the [mirage-preview](#deprecation-notice) media type.**A unique string to distinguish an authorization from others created for the same client ID and user.
`fingerprint`|`string` | A unique string to distinguish an authorization from others created for the same client ID and user.


You can only send one of these scope keys at a time.
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/2015-02-20-migration-period-removing-authorizations-token/)
[the deprecation blog post](/changes/2015-04-20-authorizations-api-response-changes-are-now-in-effect/)
and the [Authorizations API deprecation notice](/v3/oauth_authorizations/#deprecation-notice)
for full details.

Expand Down
[8]ページ先頭
©2009-2025 Movatter.jp