From 326651201c9418ba310b42064a305ee40a89cb92 Mon Sep 17 00:00:00 2001 From: Hubot Date: Wed, 10 Dec 2014 22:17:52 +0000 Subject: [PATCH] Sync changes from upstream repository --- content/v3.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/content/v3.md b/content/v3.md index f1e185fc6e..451ea03918 100644 --- a/content/v3.md +++ b/content/v3.md @@ -414,6 +414,39 @@ If you're using conditional requests and still exceeding your rate limit, please [contact us][support] to request a 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 +over a period of time. These rate limits do not apply to private repositories +or GitHub Enterprise installations. + +It is not intended for this rate limit to interfere with any legimate use of +the API. Your normal [rate limits](/v3/#rate-limiting) should be the only +limit you target. Please [contact support][abuse-support] if your use is affected by +this rate limit. + +If your application triggers this rate limit, you'll receive an informative +response: + +
+HTTP/1.1 403 Forbidden
+Content-Type: application/json; charset=utf-8
+Connection: close
+
+{
+  "errors": [
+    {
+      "resource": "IssueComment",
+      "code": "abuse",
+      "field": "base"
+    }
+  ],
+  "message": "Rate Limit Exceeded",
+  "documentation_url": "https://developer.github.com/v3#abuse-rate-limits"
+}
+
+ ## User Agent Required All API requests MUST include a valid `User-Agent` header. Requests with no `User-Agent` @@ -619,4 +652,5 @@ If the steps above don't result in any information, we use UTC as the timezone to create the git commit. [support]: https://github.com/contact?form[subject]=APIv3 +[abuse-support]: https://github.com/contact?form[subject]=API+Abuse+Rate+Limits [pagination-guide]: /guides/traversing-with-pagination