Weather Ruse
Sign in
Guides

Authentication

API keys and how to use them.

API keys

All requests to api.weather-ruse.com require an API key. Create one from the console.

Keys have the format wr-<61 characters>.

Passing your key

Authorization: Bearer wr-<your-key>

X-Api-Key header

X-Api-Key: wr-<your-key>
?api_key=wr-<your-key>

Key management

  • Create multiple keys for different environments (dev / staging / prod)
  • Revoke a key instantly from the console without downtime
  • Keys do not expire — revoke manually when rotating
  • Usage is tracked per key in the console

Security

  • Never expose keys in client-side code or public repositories
  • Use environment variables: WR_API_KEY=wr-...
  • Rotate keys immediately if compromised
# .env
WR_API_KEY=wr-IJTdCSvxZzKMDNrEVHKUNKTGUNswurzPqGcApFAhOREptOrofxGlXLJyjHpaM

# Usage
curl -H "Authorization: Bearer $WR_API_KEY" \
  "https://api.weather-ruse.com/forecast?lat=48.85&lon=2.35&variables=air_temperature_2m"

LLM Endpoints

Machine-readable API description and natural language forecast queries.

Credits

How credits are consumed and how to manage your balance.

On this page

API keysPassing your keyAuthorization header (recommended)X-Api-Key headerQuery parameter (not recommended for production)Key managementSecurity