Weather API

Introduction

The endpoint provides the user the ability to check the current weather based on geographical coordinates.

Authentication

Authentication is achieved by passing a custom header named X-Api-Key containing the API key.

Endpoint

https://api.nubila.ai/api/v1/weather

Parameters

Example Request

Example Response (success)

Example response (error)

Response Fields description

Root Fields

• ok (boolean): Indicates whether the request was successful. true indiciates successful request

• message (string): In case of unsuccessful request, a message explaining why the request failed

Metadata

• id (string): Unique identifier for the weather data record.

• created_at (string, ISO 8601): Timestamp when the record was created.

• updated_at

Location Information

• latitude (number): Latitude of the location.

• longitude (number): Longitude of the location.

• location_name (

Weather Conditions

• temperature (number): Current temperature in degrees Celsius.

• temperature_min (number): Minimum recorded temperature in degrees Celsius.

• temperature_max

Wind Data

• wind_speed (number): Wind speed in meters per second.

• wind_scale (number): Wind scale (e.g., Beaufort scale).

• wind_speed_list

Weather Condition Details

• condition (string): General weather condition (e.g., “Clouds”, “Rain”).

• condition_desc (string): Detailed weather description (e.g., “overcast clouds”).

Time & Source Information

• timestamp (number): Unix timestamp (seconds since epoch) representing the data retrieval time.

• timezone (number): Timezone offset in seconds from UTC.

System Status

• tag (string): Custom tag (if applicable).

• is_online (boolean): Indicates whether the weather station or source is online.

• is_malfunction