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,68 @@ info:
version: 1.0.0
paths:
/api/wildfire/v1/list-fire-detections:
post:
get:
tags:
- WildfireService
summary: ListFireDetections
description: ListFireDetections retrieves satellite-detected active fires from NASA FIRMS.
operationId: ListFireDetections
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListFireDetectionsRequest'
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: ne_lat
in: query
description: North-east latitude of bounding box.
required: false
schema:
type: number
format: double
- name: ne_lon
in: query
description: North-east longitude of bounding box.
required: false
schema:
type: number
format: double
- name: sw_lat
in: query
description: South-west latitude of bounding box.
required: false
schema:
type: number
format: double
- name: sw_lon
in: query
description: South-west longitude of bounding box.
required: false
schema:
type: number
format: double
responses:
"200":
description: Successful response
@@ -69,68 +119,40 @@ components:
- violations
description: ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong.
ListFireDetectionsRequest:
type: object
properties:
timeRange:
$ref: '#/components/schemas/TimeRange'
pagination:
$ref: '#/components/schemas/PaginationRequest'
boundingBox:
$ref: '#/components/schemas/BoundingBox'
description: ListFireDetectionsRequest specifies filters for retrieving fire detections from NASA FIRMS.
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.
BoundingBox:
type: object
properties:
northEast:
$ref: '#/components/schemas/GeoCoordinates'
southWest:
$ref: '#/components/schemas/GeoCoordinates'
description: |-
BoundingBox represents a rectangular geographic area defined by its corners.
Used for spatial queries to filter results within a geographic region.
GeoCoordinates:
type: object
properties:
latitude:
description: Cursor for next page.
neLat:
type: number
maximum: 90
minimum: -90
format: double
description: Latitude in decimal degrees (-90 to 90).
longitude:
description: North-east latitude of bounding box.
neLon:
type: number
maximum: 180
minimum: -180
format: double
description: Longitude in decimal degrees (-180 to 180).
description: GeoCoordinates represents a geographic location using WGS84 coordinates.
description: North-east longitude of bounding box.
swLat:
type: number
format: double
description: South-west latitude of bounding box.
swLon:
type: number
format: double
description: South-west longitude of bounding box.
description: ListFireDetectionsRequest specifies filters for retrieving fire detections from NASA FIRMS.
ListFireDetectionsResponse:
type: object
properties:
@@ -183,6 +205,22 @@ components:
required:
- id
description: FireDetection represents a satellite-detected active fire from NASA FIRMS.
GeoCoordinates:
type: object
properties:
latitude:
type: number
maximum: 90
minimum: -90
format: double
description: Latitude in decimal degrees (-90 to 90).
longitude:
type: number
maximum: 180
minimum: -180
format: double
description: Longitude in decimal degrees (-180 to 180).
description: GeoCoordinates represents a geographic location using WGS84 coordinates.
PaginationResponse:
type: object
properties: