call-sample-co-api
Call the Sample Co Weather API for forecasts, current conditions, severe-weather alerts and weather-dependent decisions at a place. Use when a task needs weather data for coordinates or a place name, or code that integrates the Weather API.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1.8k
- Forks
- 62
01 前言 Front Matter
- name
- call-sample-co-api
- description
- Call the Sample Co Weather API for forecasts, current conditions, severe-weather alerts and weather-dependent decisions at a place. Use when a task needs weather data for coordinates or a place name, or code that integrates the Weather API.
03 SKILL.md 正文
Call the Sample Co Weather API
Docs: https://demo.nimbus-docs.com/llms.txt. Every page has a Markdown version at <page>/index.md.
When to use it
- Weather now, or forecasts from minute-by-minute rain (next two hours) to daily forecasts (sixteen days).
- Severe-weather alerts from national services, polled or pushed to a webhook.
- Decisions that depend on the weather: frost risk, spray windows, soil conditions, lightning nearby.
- Also: air quality and pollen, marine (waves, tides, sea temperature), aviation (METAR, TAF), tropical cyclones, solar and wind resource, radar and satellite tiles, history back to 1940.
- Not for: forecasts beyond sixteen days, or an official aviation briefing.
Request basics
- Base URL:
https://api.weather.example/v2. - Auth:
Authorization: Bearer <key>. Keys startingwx_test_are free and return realistic fixed data;wx_live_keys are billed. Read the key fromWEATHER_API_KEY; never print it. - Times are UTC; units are metric unless you pass
units=imperial. - Versions: v2 is current. v1 stops responding on 2026-12-31; don't write new v1 code. https://demo.nimbus-docs.com/concepts/versioning/index.md
- Errors share one shape,
{"error": {"type", "code", "message", "request_id"}}. Retry429afterRetry-Afterseconds, and500with backoff. https://demo.nimbus-docs.com/concepts/errors/index.md - Lists paginate with
cursor: pass the previous response'snext_cursor. https://demo.nimbus-docs.com/concepts/pagination/index.md
Common operations
Find a place, then use its coordinates:
curl "https://api.weather.example/v2/locations/search?q=Oslo" -H "Authorization: Bearer $WEATHER_API_KEY"
Reference: https://demo.nimbus-docs.com/api/locations/search-locations/index.md
A daily forecast (days up to 16):
curl "https://api.weather.example/v2/forecasts/daily?latitude=59.91&longitude=10.75&days=7" -H "Authorization: Bearer $WEATHER_API_KEY"
Reference: https://demo.nimbus-docs.com/api/forecasts/get-daily-forecast/index.md
Active alerts, filtered by country and severity:
curl "https://api.weather.example/v2/alerts?country=NO&severity=severe" -H "Authorization: Bearer $WEATHER_API_KEY"
Reference: https://demo.nimbus-docs.com/api/alerts/list-active-alerts/index.md
Everything else
Every endpoint, grouped by product: https://demo.nimbus-docs.com/api/index.md. The OpenAPI document: https://demo.nimbus-docs.com/api/openapi.json.
04 同仓库更多 Skills
docs-style
Write documentation pages in this site's house style. Use when adding or editing docs content.
deploy-worker
Deploy this documentation site to Cloudflare Workers with Wrangler. Use when asked to ship or preview the docs.
build-a-nimbus-site
Create, write and deploy a documentation site with Nimbus (Astro). Use when a user wants a new docs site, wants to add pages or components to a Nimbus site, or wants to check, upgrade or deploy one.