Sulu logo
Sulu
Docs

Technical Overview

The Weatherman API, hosted at weatherman.ln.sulu.sh, offers a comprehensive and real-time weather data service. By accessing the /current endpoint with a city parameter, users can retrieve detailed weather information, including temperature readings in Celsius and Fahrenheit, 'feels like' temperatures, wind speed and direction, atmospheric pressure, and humidity levels. Additionally, the API provides unique weather condition codes, descriptive texts, and corresponding icon URLs, enhancing the user experience with visual representations of the current weather.

Designed for versatility and ease of use, the Weatherman API is an invaluable resource for applications requiring up-to-date weather data, from simple weather widgets to complex environmental analysis tools. Its integration with the L402 authentication scheme ensures secure and efficient access, making it a reliable choice for developers looking to incorporate weather data into their projects.

Host

https://weatherman.ln.sulu.sh

Endpoints
Price

During the development stage of the API, we are implementing a fixed price of 50 sats for unlimited access to the API designed for early testers. This will be updated once the API is completed.

Response Format

The API returns a JSON object with detailed real-time weather data. It includes a location object and a current object.

Location Object
FieldData TypeDescription
latdecimalLatitude in decimal degree
londecimalLongitude in decimal degree
namestringLocation name
regionstringRegion or state of the location, if available
countrystringLocation country
tz_idstringTime zone name
localtime_epochintLocal date and time in unix time
localtimestringLocal date and time
Current Object
FieldData TypeDescription
last_updatedstringLocal time when the data was last updated.
last_updated_epochintUnix time of the last update.
temp_cdecimalTemperature in Celsius.
temp_fdecimalTemperature in Fahrenheit.
feelslike_cdecimal'Feels like' temperature in Celsius.
feelslike_fdecimal'Feels like' temperature in Fahrenheit.
condition:textstringWeather condition description.
condition:iconstringURL of the weather condition icon.
condition:codeintUnique code for the weather condition.
wind_mphdecimalWind speed in miles per hour.
wind_kphdecimalWind speed in kilometers per hour.
wind_degreeintWind direction in degrees.
wind_dirstringWind direction as a 16-point compass (e.g., NSW).
pressure_mbdecimalAtmospheric pressure in millibars.
pressure_indecimalAtmospheric pressure in inches.
precip_mmdecimalPrecipitation in millimeters.
precip_indecimalPrecipitation in inches.
humidityintHumidity percentage.
cloudintCloud cover percentage.
is_dayintIndicates day (1) or night (0).
uvdecimalUV Index.
gust_mphdecimalWind gusts in miles per hour.
gust_kphdecimalWind gusts in kilometers per hour.

Copyright © 2024 Sulu