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

Merged
hubot merged 1 commit intomasterfromupdate-1424201754
Feb 17, 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
4 changes: 2 additions & 2 deletionscontent/v3.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -165,7 +165,7 @@ Error Name | Description
`invalid` | This means the formatting of a field is invalid. The documentation for that resource should be able to give you more specific information.
`already_exists` | This means another resource has the same value as this field. This can happen in resources that must have some unique key (such as Label names).

If resources havecustom validation errors, theywillbe documented withtheresource.
Resources may also sendcustom validation errors (where `code` is `custom`). Custom errorswillalways have a `message` field describingtheerror, as well as a `documentation_url` field pointing to some content that might help you resolve the error.

## HTTP Redirects

Expand DownExpand Up@@ -417,7 +417,7 @@ higher rate limit for your OAuth application.
### Abuse Rate Limits

To prevent abuse, additional rate limits apply to some endpoints that
create content. This rate limit applies to the creation of new content
create content. This rate limit applies to the creation of new content
over a period of time. These rate limits do not apply to private repositories
or GitHub Enterprise installations.

Expand Down
41 changes: 21 additions & 20 deletionscontent/v3/activity/notifications.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -7,15 +7,14 @@ title: Notifications | GitHub API
* TOC
{:toc}

GitHub Notifications are powered by [watched repositories](/v3/activity/watching/).
Users receive notifications for discussions in repositories they watch
Users receive notifications for conversations in repositories they watch
including:

* Issues and their comments
* Pull Requests and their comments
* Comments on any commits

Notifications are also sent fordiscussions in unwatched repositories when the
Notifications are also sent forconversations in unwatched repositories when the
user is involved including:

* **@mentions**
Expand DownExpand Up@@ -59,20 +58,20 @@ Here's a list of potential `reason`s for receiving a notification:
Reason Name | Description
------------|------------
`subscribed` | The notification arrived because you're watching the repository
`manual` | The notification arrived because you've specifically decided towatchtheitem (via an Issue or Pull Request)
`author` | The notification arrived because you've created theitem
`comment` | The notification arrived because you've commented on theitem
`mention` | The notification arrived because you were specifically **@mentioned** in the content
`team_mention` | The notification arrived because you were on a team that was mentioned (like @org/team)
`state_change` | The notification arrived because you changed theitem state (like closing an Issue or merging a Pull Request)
`assign` | The notification arrived because you were assigned to the Issue
`manual` | The notification arrived because you've specifically decided tosubscribe tothethread (via an Issue or Pull Request)
`author` | The notification arrived because you've created thethread
`comment` | The notification arrived because you've commented on thethread
`mention` | The notification arrived because you were specifically **@mentioned** in the content
`team_mention` | The notification arrived because you were on a team that was mentioned (like @org/team)
`state_change` | The notification arrived because you changed thethread state (like closing an Issue or merging a Pull Request)
`assign` | The notification arrived because you were assigned to the Issue

Note that the `reason` is modified on a per-thread basis, and can change, if the
`reason` on a later notification is different.
`reason` on a later notification is different.

For example, if you are the author of an issue, subsequent notifications on that
issue will have a `reason` of `author`. If you're then **@mentioned** on the same
issue, the notifications you fetch thereafter will have a `reason` of `mention`.
For example, if you are the author of an issue, subsequent notifications on that
issue will have a `reason` of `author`. If you're then **@mentioned** on the same
issue, the notifications you fetch thereafter will have a `reason` of `mention`.
The `reason` remains as `mention`, regardless of whether you're ever mentioned again.

## List your notifications
Expand DownExpand Up@@ -142,7 +141,7 @@ from the [default view on GitHub.com](https://github.com/notifications).

### Parameters

Name | Type | Description
Name | Type | Description
-----|------|--------------
`last_read_at`|`string` | Describes the last point that notifications were checked. Anything updated since this time will not be updated. This is a timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. Default: `Time.now`

Expand DownExpand Up@@ -173,6 +172,12 @@ Name | Type | Description
This checks to see if the current user is subscribed to a thread. You can also
[get a Repository subscription](/v3/activity/watching/#get-a-repository-subscription).

{{#tip}}

Note that subscriptions are only generated if a user is participating in a conversation--for example, they've replied to the thread, were **@mention**ed, or manually subscribe to a thread.

{{/tip}}

GET /notifications/threads/:id/subscription

### Response
Expand All@@ -182,10 +187,7 @@ This checks to see if the current user is subscribed to a thread. You can also

## Set a Thread Subscription

This lets you subscribe to a thread, or ignore it. Subscribing to a thread
is unnecessary if the user is already subscribed to the repository. Ignoring
a thread will mute all future notifications (until you comment or get
@mentioned).
This lets you subscribe or unsubscribe from a conversation. Unsubscribing from a conversation mutes all future notifications (until you comment or get **@mention**ed once more).

PUT /notifications/threads/:id/subscription

Expand All@@ -209,4 +211,3 @@ Name | Type | Description
### Response

<%= headers 204 %>

11 changes: 11 additions & 0 deletionscontent/v3/activity/watching.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -71,6 +71,11 @@ Name | Type | Description
`subscribed`|`boolean`| Determines if notifications should be received from this repository.
`ignored`|`boolean`| Determines if all notifications should be blocked from this repository.

{{#tip}}

If you would like to watch a repository, set `subscribed` to `true`. If you would like to ignore notifications made within a repository, set `ignored` to `true`. If you would like to stop watching a repository, [delete the repository's subscription](#delete-a-repository-subscription) completely.

{{/tip}}

### Response

Expand All@@ -79,6 +84,12 @@ Name | Type | Description

## Delete a Repository Subscription

{{#tip}}

This endpoint should only be used to stop watching a repository. To control whether or not you wish to receive notifications from a repository, [set the repository's subscription manually](#set-a-repository-subscription).

{{/tip}}

DELETE /repos/:owner/:repo/subscription

### Response
Expand Down
5 changes: 2 additions & 3 deletionscontent/v3/pulls.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -199,9 +199,8 @@ Name | Type | Description

<%= headers 405 %>
<%= json \
:sha => nil,
:merged => false,
:message => 'Failure reason'
:message => "Pull Request is not mergeable",
:documentation_url => "https://developer.github.com/v3/pulls/#merge-a-pull-request-merge-button"
%>

### Labels, assignees, and milestones
Expand Down
11 changes: 9 additions & 2 deletionslib/resources.rb
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -733,7 +733,8 @@ def fetch_content(key)
TEAM ||= {
"id" => 1,
"url" => "https://api.github.com/teams/1",
"name" => "Owners",
"name" => "Justice League",
"slug" => "justice-league",
"description" => "A great team.",
"permission" => "admin",
"members_url" => "https://api.github.com/teams/1/members{/member}",
Expand DownExpand Up@@ -1664,6 +1665,7 @@ def fetch_content(key)
"url" => "https://api.github.com/repos/pengwynn/octokit/contents/README.md",
"git_url" => "https://api.github.com/repos/pengwynn/octokit/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
"html_url" => "https://github.com/pengwynn/octokit/blob/master/README.md",
"download_url" => "https://raw.githubusercontent.com/pengwynn/octokit/master/README.md",
"_links" => {
"git" => "https://api.github.com/repos/pengwynn/octokit/git/blobs/3d21ec53a331a6f037a91c368710b99387d012c1",
"self" => "https://api.github.com/repos/pengwynn/octokit/contents/README.md",
Expand All@@ -1681,6 +1683,7 @@ def fetch_content(key)
"url" => "https://api.github.com/repos/pengwynn/octokit/contents/bin/some-symlink",
"git_url" => "https://api.github.com/repos/pengwynn/octokit/git/blobs/452a98979c88e093d682cab404a3ec82babebb48",
"html_url" => "https://github.com/pengwynn/octokit/blob/master/bin/some-symlink",
"download_url" => "https://raw.githubusercontent.com/pengwynn/octokit/master/bin/some-symlink",
"_links" => {
"git" => "https://api.github.com/repos/pengwynn/octokit/git/blobs/452a98979c88e093d682cab404a3ec82babebb48",
"self" => "https://api.github.com/repos/pengwynn/octokit/contents/bin/some-symlink",
Expand All@@ -1698,6 +1701,7 @@ def fetch_content(key)
"url" => "https://api.github.com/repos/jquery/jquery/contents/test/qunit?ref=master",
"git_url" => "https://api.github.com/repos/jquery/qunit/git/trees/6ca3721222109997540bd6d9ccd396902e0ad2f9",
"html_url" => "https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9",
"download_url" => nil,
"_links" => {
"git" => "https://api.github.com/repos/jquery/qunit/git/trees/6ca3721222109997540bd6d9ccd396902e0ad2f9",
"self" => "https://api.github.com/repos/jquery/jquery/contents/test/qunit?ref=master",
Expand All@@ -1715,6 +1719,7 @@ def fetch_content(key)
"url" => "https://api.github.com/repos/pengwynn/octokit/contents/lib/octokit.rb",
"git_url" => "https://api.github.com/repos/pengwynn/octokit/git/blobs/fff6fe3a23bf1c8ea0692b4a883af99bee26fd3b",
"html_url" => "https://github.com/pengwynn/octokit/blob/master/lib/octokit.rb",
"download_url" => "https://raw.githubusercontent.com/pengwynn/octokit/master/lib/octokit.rb",
"_links" => {
"self" => "https://api.github.com/repos/pengwynn/octokit/contents/lib/octokit.rb",
"git" => "https://api.github.com/repos/pengwynn/octokit/git/blobs/fff6fe3a23bf1c8ea0692b4a883af99bee26fd3b",
Expand All@@ -1730,6 +1735,7 @@ def fetch_content(key)
"url" => "https://api.github.com/repos/pengwynn/octokit/contents/lib/octokit",
"git_url" => "https://api.github.com/repos/pengwynn/octokit/git/trees/a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
"html_url" => "https://github.com/pengwynn/octokit/tree/master/lib/octokit",
"download_url" => nil,
"_links" => {
"self" => "https://api.github.com/repos/pengwynn/octokit/contents/lib/octokit",
"git" => "https://api.github.com/repos/pengwynn/octokit/git/trees/a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d",
Expand DownExpand Up@@ -1849,6 +1855,7 @@ def fetch_content(key)
"url" => "https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt",
"html_url" => "https://github.com/octocat/Hello-World/blob/master/notes/hello.txt",
"git_url" => "https://api.github.com/repos/octocat/Hello-World/git/blobs/95b966ae1c166bd92f8ae7d1c313e738c731dfc3",
"download_url" => "https://raw.githubusercontent.com/octocat/HelloWorld/master/notes/hello.txt",
"type" => "file",
"_links" => {
"self" => "https://api.github.com/repos/octocat/Hello-World/contents/notes/hello.txt",
Expand DownExpand Up@@ -2179,7 +2186,7 @@ def fetch_content(key)
"client_id" => "12313412",
"client_secret" => "kj123131132",
"organization_name" => "Homestar Runners",
"organization_team" => "homestarrunners/owners"
"organization_team" => "homestarrunners/characters"
},
"smtp" => {
"enabled" => true,
Expand Down

[8]ページ先頭

©2009-2025 Movatter.jp