CCM-13554 - Update 429 response

Author: nhsd-david-wass

sandbox/data/examples/errors/responses/tooManyRequests.json

@@ -1,14 +1,10 @@
 {
-  "errors": [
-    {
-      "code": "NOTIFY_QUOTA",
-      "detail": "You have made too many requests. Please try again later.",
-      "id": "rrt-1931948104716186917-c-geu2-10664-3111479-3.0",
-      "links": {
-        "about": "https://digital.nhs.uk/developer/api-catalogue/nhs-notify-supplier"
-      },
-      "status": "429",
-      "title": "Too many requests"
-    }
-  ]
+  "interval": 1,
+  "limit": 1,
+  "message": "Your application, Notify-Supplier-App-Restricted - Internal Dev 2, has exceeded its quota of 1 requests every 1 minute(s) and is being rate limited.",
+  "message_id": "rrt-4773181658036170775-c-geu2-321623-73628915-2",
+  "policy": "quota",
+  "ratelimiting_expiry_time_ms": 1765372560000,
+  "scope": "application",
+  "timeunit": "minute"
 }

specification/api/components/responses/errors/tooManyRequests.yml

@@ -1,8 +1,33 @@
 description: Too many requests
 content:
-  application/vnd.api+json:
+  application/json:
     schema:
-      $ref: "../../schemas/errorResponse.yml"
+      type: object
+      properties:
+        message:
+          type: string
+          example: "Your application has exceeded its quota"
+        scope:
+          type: string
+          example: "application"
+        policy:
+          type: string
+          example: "quota"
+        limit:
+          type: integer
+          example: 300
+        interval:
+          type: integer
+          example: 1
+        timeunit:
+          type: string
+          example: "minute"
+        ratelimiting_expiry_time_ms:
+          type: integer
+          example: 1625498765123
+        message_id:
+          type: string
+          example: "rrt-4773181658036170775-c-geu2-321623-73628915-2"
     examples:
       error-too-many-requests:
         $ref: ../../examples/errors/responses/tooManyRequests.json