Merge pull request #667 from github/update-1418249860

Hubot · Hubot · commit a0d63d3e999a · 2014-12-10T16:17:56.000-06:00
diff --git 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:
+
+<pre class="terminal">
+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"
+}
+</pre>
+
 ## 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
