feat: convert 52 API endpoints from POST to GET for edge caching (#468)

* feat: convert 52 API endpoints from POST to GET for edge caching

Convert all cacheable sebuf RPC endpoints to HTTP GET with query/path
parameters, enabling CDN edge caching to reduce costs. Flatten nested
request types (TimeRange, PaginationRequest, BoundingBox) into scalar
query params. Add path params for resource lookups (GetFredSeries,
GetHumanitarianSummary, GetCountryStockIndex, GetCountryIntelBrief,
GetAircraftDetails). Rewrite router with hybrid static/dynamic matching
for path param support.

Kept as POST: SummarizeArticle, ClassifyEvent, RecordBaselineSnapshot,
GetAircraftDetailsBatch, RegisterInterest.

Generated with sebuf v0.9.0 (protoc-gen-ts-client, protoc-gen-ts-server).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add rate_limited field to market response protos

The rateLimited field was hand-patched into generated files on main but
never declared in the proto definitions. Regenerating wiped it out,
breaking the build. Now properly defined in both ListEtfFlowsResponse
and ListMarketQuotesResponse protos.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: remove accidentally committed .planning files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Sebastien Melki
2026-02-27 17:44:40 +02:00
committed by GitHub
parent 5f908c0929
commit 6669d373cf
169 changed files with 3806 additions and 1860 deletions

View File

@@ -4,18 +4,47 @@ info:
version: 1.0.0
paths:
/api/seismology/v1/list-earthquakes:
post:
get:
tags:
- SeismologyService
summary: ListEarthquakes
description: ListEarthquakes retrieves recent earthquakes from the USGS GeoJSON feed.
operationId: ListEarthquakes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListEarthquakesRequest'
required: true
parameters:
- name: start
in: query
description: Start of time range (inclusive), Unix epoch milliseconds.
required: false
schema:
type: string
format: int64
- name: end
in: query
description: End of time range (inclusive), Unix epoch milliseconds.
required: false
schema:
type: string
format: int64
- name: page_size
in: query
description: Maximum items per page (1-100).
required: false
schema:
type: integer
format: int32
- name: cursor
in: query
description: Cursor for next page.
required: false
schema:
type: string
- name: min_magnitude
in: query
description: Minimum magnitude filter (e.g., 4.0 for significant quakes).
required: false
schema:
type: number
format: double
responses:
"200":
description: Successful response
@@ -69,45 +98,28 @@ components:
- violations
description: ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong.
ListEarthquakesRequest:
type: object
properties:
timeRange:
$ref: '#/components/schemas/TimeRange'
pagination:
$ref: '#/components/schemas/PaginationRequest'
minMagnitude:
type: number
minimum: 0
format: double
description: Minimum magnitude filter (e.g., 4.0 for significant quakes).
description: ListEarthquakesRequest specifies filters for retrieving earthquake data from USGS.
TimeRange:
type: object
properties:
start:
type: integer
format: int64
description: 'Start of the time range (inclusive), as Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript'
description: 'Start of time range (inclusive), Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript'
end:
type: integer
format: int64
description: 'End of the time range (inclusive), as Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript'
description: |-
TimeRange represents a time interval defined by a start and end timestamp.
Used for filtering data within a specific time period.
PaginationRequest:
type: object
properties:
description: 'End of time range (inclusive), Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript'
pageSize:
type: integer
maximum: 100
minimum: 1
format: int32
description: Maximum number of items to return per page (1 to 100).
description: Maximum items per page (1-100).
cursor:
type: string
description: Opaque cursor for fetching the next page. Empty string for the first page.
description: PaginationRequest specifies cursor-based pagination parameters for list endpoints.
description: Cursor for next page.
minMagnitude:
type: number
format: double
description: Minimum magnitude filter (e.g., 4.0 for significant quakes).
description: ListEarthquakesRequest specifies filters for retrieving earthquake data from USGS.
ListEarthquakesResponse:
type: object
properties: