daedalmap-com Ops API

openapi: 3.2.0
info:
  title: County Map Ops API
  description: Geographic data exploration API
  version: 0.4.0
tags:
- name: Ops
paths:
  /ops:
    get:
      summary: Serve Lane Shell
      description: 'Serve the same SPA shell for lane deep-links (/ops, /research).


        The client reads the active lane from the URL path. Unlike the marketing

        routes in app.py, these must NOT redirect to the www site -- they are the

        app itself, just entered directly at a lane.'
      operationId: serve_lane_shell_ops_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
      tags:
      - Ops
  /api/ops/ticker:
    get:
      summary: Ops Ticker Endpoint
      description: 'Live announcement ticker items (space weather, etc.). Public, read-only.


        Open in all modes - the ticker is a standalone announcement bar, not tied to

        a watch or the chat ops_report.'
      operationId: ops_ticker_endpoint_api_ops_ticker_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Ops
  /api/ops/aurora:
    get:
      summary: Ops Aurora Endpoint
      description: 'Latest OVATION aurora model band for the map overlay. Public, read-only.


        Returns the renderable cells [[lon, lat, probability], ...] plus the forecast

        timestamps, straight from the noaa_aurora live snapshot.'
      operationId: ops_aurora_endpoint_api_ops_aurora_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Ops
  /api/ops/aurora/frames:
    get:
      summary: Ops Aurora Frames Endpoint
      description: Rolling, compact Aurora model frames for the real-history loop.
      operationId: ops_aurora_frames_endpoint_api_ops_aurora_frames_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Ops
  /api/ops/nws-alerts:
    get:
      summary: Ops Nws Alerts Endpoint
      description: 'NWS active alerts as a GeoJSON overlay. Public, read-only.


        Each alert renders as its exact warning polygon when the feed provided one,

        else the highlighted affected county polygons, else a pin at the centroid.'
      operationId: ops_nws_alerts_endpoint_api_ops_nws_alerts_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Ops
  /api/ops/wildfires/perimeters:
    get:
      summary: Ops Wildfire Perimeters Endpoint
      description: 'Return simplified current fire perimeters only for a close viewport.


        The normal wildfire snapshot remains compact marker state. Perimeters are

        stable detail geometry, requested only after an operator has zoomed in and

        only for incidents whose supplied point lies inside the current viewport.'
      operationId: ops_wildfire_perimeters_endpoint_api_ops_wildfires_perimeters_get
      parameters:
      - name: bbox
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Bbox
      - name: min_area_km2
        in: query
        required: false
        schema:
          type: number
          default: 50.0
          title: Min Area Km2
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Ops
  /api/ops/points/{overlay_id}:
    get:
      summary: Ops Points Endpoint
      description: 'Generic live point-feed overlay (GeoJSON points). Public, read-only.


        One endpoint for every registered "location with updating data" feed (ocean

        buoys, weather stations, sensors): each point carries its latest reading for

        the click popup. See mapmover/ops_point_feeds.py POINT_FEEDS.'
      operationId: ops_points_endpoint_api_ops_points__overlay_id__get
      parameters:
      - name: overlay_id
        in: path
        required: true
        schema:
          type: string
          title: Overlay Id
      - name: bbox
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Bbox
      - name: zoom
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Zoom
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Ops
  /api/ops/openaq/stations/{location_id}:
    get:
      summary: Openaq Station Detail Endpoint
      description: Fetch one OpenAQ station's complete current metadata/readings on demand.
      operationId: openaq_station_detail_endpoint_api_ops_openaq_stations__location_id__get
      parameters:
      - name: location_id
        in: path
        required: true
        schema:
          type: integer
          title: Location Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Ops
  /api/ops/report:
    post:
      summary: Ops Report Endpoint
      operationId: ops_report_endpoint_api_ops_report_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Ops
  /api/ops/load-watch:
    post:
      summary: Ops Load Watch Endpoint
      operationId: ops_load_watch_endpoint_api_ops_load_watch_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Ops
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError