docs: update yaml schema files

public/v1/components/headers.yaml

@@ -41,3 +41,8 @@ components:
       required: false
       schema:
         type: integer
+    RetryAfter:
+      description: The number of seconds remaining until the request of this measurement is available again.
+      required: true
+      schema:
+        type: integer

public/v1/components/responses.yaml

@@ -169,6 +169,35 @@ components:
               $ref: 'examples.yaml#/components/examples/getMtrMeasurementResponse'
             httpMeasurement:
               $ref: 'examples.yaml#/components/examples/getHttpMeasurementResponse'
+    measurement429:
+      description: |
+        If you've exceeded the API rate limit, you'll receive status `429 Too Many Requests` and a body containing more information about the error.
+      headers:
+        Retry-After:
+          $ref: 'headers.yaml#/components/headers/RetryAfter'
+      content:
+        application/json:
+          schema:
+            type: object
+            required:
+              - error
+            properties:
+              error:
+                type: object
+                required:
+                  - type
+                  - message
+                properties:
+                  type:
+                    type: string
+                  message:
+                    type: string
+          examples:
+            json:
+              value:
+                error:
+                  type: too_many_requests
+                  message: Too Many Requests.
     probes200:
       description: |
         A successful request returns status `200 OK` and a body containing a list of all probes currently online and their metadata.

public/v1/spec.yaml

@@ -105,8 +105,13 @@ paths:
           $ref: 'components/responses.yaml#/components/responses/measurement200'
         '404':
           $ref: 'components/responses.yaml#/components/responses/404'
+        '429':
+          $ref: 'components/responses.yaml#/components/responses/measurement429'
       tags:
         - Measurements
+      security:
+        - {}
+        - bearerAuth: []
   /v1/probes:
     get:
       summary: List probes currently online

src/lib/rate-limiter/rate-limiter-get.ts

@@ -55,7 +55,7 @@ export const getMeasurementRateLimit = async (ctx: ExtendedContext, next: Next)
 	} catch (error) {
 		if (error instanceof RateLimiterRes) {
 			setRateLimitHeaders(ctx, error);
-			throw createHttpError(429, 'Too Many Requests', { type: 'too_many_requests' });
+			throw createHttpError(429, 'Too Many Requests.', { type: 'too_many_requests' });
 		}
 
 		throw createHttpError(500);

src/measurement/route/get-measurement.ts

@@ -4,6 +4,7 @@ import { getMeasurementStore } from '../store.js';
 import { corsAuthHandler } from '../../lib/http/middleware/cors.js';
 import { authenticate } from '../../lib/http/middleware/authenticate.js';
 import { getMeasurementRateLimit } from '../../lib/rate-limiter/rate-limiter-get.js';
+import createHttpError from 'http-errors';
 
 const store = getMeasurementStore();
 
@@ -18,8 +19,7 @@ const handle = async (ctx: ParameterizedContext<DefaultState, DefaultContext & R
 	const result = await store.getMeasurementString(id);
 
 	if (!result) {
-		ctx.status = 404;
-		return;
+		throw createHttpError(404, `Couldn't find the requested item.`, { type: 'not_found' });
 	}
 
 	ctx.type = 'application/json';