Add Rate Limit header info and update limit info

Author: bbiggerr

openapi.yaml

@@ -341,8 +341,7 @@ info:
 
     ## Rate Limiting
 
-    With the Linode API, you can make up to 1,600 general API requests every two minutes per user as
-    determined by IP address or by OAuth token. Additionally, there are endpoint specific limits defined below.
+    With the Linode API, you can make up to 1,600 general API requests every two minutes per user as determined by IP address or by OAuth token. Additionally, all endpoints have a global limit of 800 requests per minute per user along with specific endpoint limits defined below.
 
     **Note:** There may be rate limiting applied at other levels outside of the API, for example, at the load balancer.
 
@@ -374,6 +373,23 @@ info:
 
     * [Service Transfer Accept](/docs/api/account/#service-transfer-accept)
 
+    All GET requests to endpoints that return a `data` collection have a dedicated limit of 100 requests per minute and 10 requests per second per user.
+
+    ## Rate Limit Response Headers
+
+    The Linode API includes the following HTTP response headers related to rate limiting:
+
+    * **X-RateLimit-Limit**: The maximum number of permitted requests during the rate limit window for this endpoint.
+    * **X-RateLimit-Remaining**: The remaining number of permitted requests in the current rate limit window.
+    * **X-RateLimit-Reset**: The time when the current rate limit window rests in UTC epoch seconds.
+    * **Retry-After**: The remaining time in seconds until the current rate limit window resets.
+
+    To view HTTP response headers when making requests with `curl`, use the `-i` or `--include` option. For example:
+
+    ```Shell
+    curl -i "https://api.linode.com/v4/regions"
+    ```
+
     ## CLI (Command Line Interface)
 
     The <a href="https://github.com/linode/linode-cli" target="_top">Linode CLI</a> allows you to easily