Document unauth'd rate limited calls

pengwynn · pengwynn · commit 426111f07fdf · 2012-08-07T08:06:18.000-05:00
diff --git a/content/v3.md b/content/v3.md
@@ -226,8 +226,27 @@ You can also check your rate limit status without incurring an API hit.
 <%= headers 200 %>
 <%= json :rate => {:remaining => 4999, :limit => 5000}  %>
 
-Please [contact us](https://github.com/contact) to request white listed access for your application.  We prefer sites that
-setup OAuth applications for their users.
+#### Unauthenticated rate limited requests
+
+If you need to make unauthenticated calls but need to use a higher rate limit
+associated with your OAuth application, you can send over your client ID and
+secret in the query string.
+
+<pre class="terminal">
+$ curl -i https://api.github.com/users/whatever?client_id=xxxxxxxxxxxxxx&client_secret=yyyyyyyyyyyyyyyyyyyyy
+
+HTTP/1.1 200 OK
+Status: 200 OK
+X-RateLimit-Limit: 12500
+X-RateLimit-Remaining: 11966
+</pre>
+
+This method should only used for server-to-server calls. You should never share
+your client secret with anyone or include it in client-side browser code.
+
+Please [contact us](https://github.com/contact) to request white listed access
+for your application.  We prefer sites that setup OAuth applications for their
+  users.
 
 ## Conditional Requests
 
