|
25 | 25 | * `/users/:user/watched` - A list of repositories that a user has starred. |
26 | 26 | * `/user/watched` - A list of repositories the current user has starred. |
27 | 27 |
|
28 | | -[starring-api]: http://developer.github.com/v3/repos/watching/ |
| 28 | +[starring-api]: http://developer.github.com/v3/repos/starring/ |
29 | 29 |
|
30 | 30 | ## Phase 1: Add Watchers as Subscriptions |
31 | 31 |
|
|
43 | 43 | * `/users/:user/starred` - A list of repositories that a user has starred. |
44 | 44 | * `/user/starred` - A list of repositories the current user has starred. |
45 | 45 |
|
46 | | -Thiswill be donewith the currentmime type for the API: |
| 46 | +Thisis in place _now_with the currentmedia type for the API: |
47 | 47 |
|
48 | 48 | application/vnd.github.beta+json |
49 | 49 |
|
50 | 50 | If you care about your application not breaking, make sure all outgoing API |
51 | | -requests pass that value for the "Accept" header. You should do this now, even |
52 | | -before Phase 1 starts. |
| 51 | +requests pass that value for the "Accept" header. You should do this now. This |
| 52 | +can be verified by checking the `X-GitHub-Media-Type` header on all API |
| 53 | +responses. |
53 | 54 |
|
54 | 55 | # Accesses a user's starred repositories. |
55 | 56 | curl https://api.github.com/user/watched \ |
56 | 57 | -H "Accept: application/vnd.github.beta+json" |
57 | 58 |
|
58 | 59 | This Phase will be broken once Phase 3 starts. Phase 3 removes all support for |
59 | | -the "beta"mime type, and makes the "v3"mime type the implicit default |
| 60 | +the "beta"media type, and makes the "v3"media type the implicit default |
60 | 61 | for API requests. |
61 | 62 |
|
62 | 63 | ## Phase 2: Switch `/watchers` API Endpoint |
|
65 | 66 | will have to use `/user/starred` to get a user's starred repositories, not |
66 | 67 | `/user/watched`. |
67 | 68 |
|
68 | | -This requires a newmime type value: |
| 69 | +This requires a newmedia type value: |
69 | 70 |
|
70 | 71 | application/vnd.github.v3+json |
71 | 72 |
|
72 | 73 | This is a breaking change from Phase 1. We will release this change in an |
73 | 74 | experimental mode first, letting developers gracefully upgrade their |
74 | | -applications by specifying the newmime value for the Accept header. |
| 75 | +applications by specifying the newmedia value for the Accept header. |
75 | 76 |
|
76 | 77 | # Accesses a user's watched repositories. |
77 | 78 | curl https://api.github.com/user/watched \ |
|
83 | 84 | point, you should be using the starring endpoints for starred repositories, and |
84 | 85 | the watch endpoints for watched repositories. |
85 | 86 |
|
86 | | -Keep on passing the "v3"mimetype in your application, until the API has |
| 87 | +Keep on passing the "v3"media type in your application, until the API has |
87 | 88 | another breaking change to make. |
88 | 89 |
|