From 6c0653f58990be70bc347c3e5995cac84aa7e506 Mon Sep 17 00:00:00 2001
From: Javier Cicchelli <javier@rock-n-code.com>
Date: Mon, 13 Oct 2025 14:59:29 +0200
Subject: [PATCH] Defined the "RateLimit", "RateLimitRemaining", and the
 "RateLimitUsed" headers for the Open API specification document in the
 library target.

---
 Sources/DiscogsService/openapi.yaml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/Sources/DiscogsService/openapi.yaml b/Sources/DiscogsService/openapi.yaml
index 4bae986e4..3d1e82d4c 100644
--- a/Sources/DiscogsService/openapi.yaml
+++ b/Sources/DiscogsService/openapi.yaml
@@ -658,6 +658,31 @@ components:
       schema:
         type: string
         example: <https://api.discogs.com/artists/1/releases?page=2&per_page=75>; rel="next", <https://api.discogs.com/artists/1/releases?page=30&per_page=75>; rel="last"
+      required: true
+    RateLimit:
+      description: A total number of requests that can be made in a minute window.
+      schema:
+        type: integer
+        minimum: 25
+        maximum: 60
+        example: 60
+      required: true
+    RateLimitRemaining:
+      description: A number of remaining requests that can be made in an existing rate limit window.
+      schema:
+        type: integer
+        minimum: 0
+        maximum: 60
+        example: 59
+      required: true
+    RateLimitUsed:
+      description: A number of requests that have been made in an existing rate limit window.
+      schema:
+        type: integer
+        minimum: 0
+        maximum: 60
+        example: 1
+      required: true
   parameters:
     ArtistId:
       name: artist_id