38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# weatherapi
|
|
|
|
`weatherapi` is a read-only HTTP API for weather data already stored by
|
|
`weatherfeeder` in PostgreSQL. It exposes the latest observations, current
|
|
conditions, alerts, forecasts, discussions, and weather stories as JSON, XML,
|
|
or text.
|
|
|
|
## Quickstart
|
|
|
|
The service needs a reachable Postgres database with weatherfeeder-owned tables
|
|
and the configured text template directory.
|
|
|
|
```sh
|
|
go run ./cmd/weatherapi -config config.yml
|
|
```
|
|
|
|
The checked-in `config.yml` is a local sample. For new deployments, start from
|
|
[`examples/config.minimal.yml`](examples/config.minimal.yml) or
|
|
[`examples/config.production.yml`](examples/config.production.yml) and provide
|
|
database credentials through your normal secret-management process.
|
|
|
|
## Endpoint Families
|
|
|
|
- Observations and current conditions
|
|
- Active alerts
|
|
- Hourly and narrative forecasts
|
|
- Forecast discussions
|
|
- Weather stories
|
|
|
|
See [`docs/api.md`](docs/api.md) for the HTTP contract.
|
|
|
|
## Documentation
|
|
|
|
- [`docs/api.md`](docs/api.md): public HTTP API reference
|
|
- [`docs/cli.md`](docs/cli.md): command-line usage
|
|
- [`docs/config.md`](docs/config.md): YAML configuration reference
|
|
- [`docs/policy/architecture.md`](docs/policy/architecture.md): development architecture and invariants
|