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,41 @@ info:
version: 1.0.0
paths:
/api/maritime/v1/get-vessel-snapshot:
post:
get:
tags:
- MaritimeService
summary: GetVesselSnapshot
description: GetVesselSnapshot retrieves a point-in-time view of AIS vessel traffic and disruptions.
operationId: GetVesselSnapshot
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetVesselSnapshotRequest'
required: true
parameters:
- name: ne_lat
in: query
description: North-east corner latitude of bounding box.
required: false
schema:
type: number
format: double
- name: ne_lon
in: query
description: North-east corner longitude of bounding box.
required: false
schema:
type: number
format: double
- name: sw_lat
in: query
description: South-west corner latitude of bounding box.
required: false
schema:
type: number
format: double
- name: sw_lon
in: query
description: South-west corner longitude of bounding box.
required: false
schema:
type: number
format: double
responses:
"200":
description: Successful response
@@ -36,18 +59,32 @@ paths:
schema:
$ref: '#/components/schemas/Error'
/api/maritime/v1/list-navigational-warnings:
post:
get:
tags:
- MaritimeService
summary: ListNavigationalWarnings
description: ListNavigationalWarnings retrieves active maritime safety warnings from NGA.
operationId: ListNavigationalWarnings
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListNavigationalWarningsRequest'
required: true
parameters:
- 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: area
in: query
description: Optional area filter (e.g., "NAVAREA IV", "Persian Gulf").
required: false
schema:
type: string
responses:
"200":
description: Successful response
@@ -103,35 +140,23 @@ components:
GetVesselSnapshotRequest:
type: object
properties:
boundingBox:
$ref: '#/components/schemas/BoundingBox'
neLat:
type: number
format: double
description: North-east corner latitude of bounding box.
neLon:
type: number
format: double
description: North-east corner longitude of bounding box.
swLat:
type: number
format: double
description: South-west corner latitude of bounding box.
swLon:
type: number
format: double
description: South-west corner longitude of bounding box.
description: GetVesselSnapshotRequest specifies filters for the vessel snapshot.
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:
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.
GetVesselSnapshotResponse:
type: object
properties:
@@ -186,6 +211,22 @@ components:
required:
- id
description: AisDensityZone represents a zone of concentrated vessel traffic.
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.
AisDisruption:
type: object
properties:
@@ -243,25 +284,17 @@ components:
ListNavigationalWarningsRequest:
type: object
properties:
pagination:
$ref: '#/components/schemas/PaginationRequest'
pageSize:
type: integer
format: int32
description: Maximum items per page (1-100).
cursor:
type: string
description: Cursor for next page.
area:
type: string
description: Optional area filter (e.g., "NAVAREA IV", "Persian Gulf").
description: ListNavigationalWarningsRequest specifies filters for retrieving NGA warnings.
PaginationRequest:
type: object
properties:
pageSize:
type: integer
maximum: 100
minimum: 1
format: int32
description: Maximum number of items to return per page (1 to 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.
ListNavigationalWarningsResponse:
type: object
properties: