{ "openapi": "3.1.0", "info": { "title": "Interzoid Global Weather Info API", "description": "This API provides current weather information for a specified location worldwide, including temperature, weather conditions, wind speed, and direction.\nTo use this API, you need an API key. Register for an API key at [Interzoid Registration](https://www.interzoid.com/register-api-account).\nFor more information about this API, visit the [Interzoid Global Weather Info API Documentation](https://www.interzoid.com/apis/global-weather-info).\n", "version": "1.0.0", "contact": { "name": "Interzoid Support", "url": "https://www.interzoid.com", "email": "support@interzoid.com" } }, "externalDocs": { "description": "API home page and documentation", "url": "https://www.interzoid.com/apis/global-weather-info" }, "servers": [ { "url": "https://api.interzoid.com", "description": "Production server" } ], "tags": [ { "name": "Global Weather Information", "description": "Provides current weather data for locations worldwide." } ], "paths": { "/getglobalweather": { "get": { "operationId": "getGlobalWeather", "tags": [ "Global Weather Information" ], "summary": "Get Current Weather Information", "description": "Retrieves current weather information for a specified location. Include your API key (license) in the request. Register for an API key at https://www.interzoid.com/register-api-account.\n", "parameters": [ { "name": "license", "in": "query", "required": true, "description": "Your API license key. Register for an API key at [Interzoid Registration](https://www.interzoid.com/register-api-account).\n", "schema": { "type": "string" }, "examples": { "license": { "summary": "API Key Example", "value": "r2d7df664a7c4ef6h8k" } } }, { "name": "location", "in": "query", "required": true, "description": "The location for which weather information is requested (e.g., city name).", "schema": { "type": "string" }, "examples": { "location": { "summary": "Location Example", "value": "Madrid" } } } ], "responses": { "200": { "description": "Successful response containing the weather information.", "content": { "application/json": { "schema": { "type": "object", "properties": { "TempF": { "type": "string", "description": "Temperature in Fahrenheit." }, "TempC": { "type": "string", "description": "Temperature in Celsius." }, "Weather": { "type": "string", "description": "Current weather condition." }, "WindSpeed": { "type": "string", "description": "Wind speed in miles per hour." }, "WindDir": { "type": "string", "description": "Wind direction." }, "Code": { "type": "string", "description": "Response code, \"Success\" if the call is successful." }, "Credits": { "type": "integer", "description": "Remaining credits for your API license." } } }, "examples": { "success": { "value": { "TempF": "53.6", "TempC": "12", "Weather": "Rain", "WindSpeed": "7", "WindDir": "WSW", "Code": "Success", "Credits": 45132 } } } } } }, "400": { "description": "Bad request (e.g., missing or invalid parameters).", "content": { "text/plain": { "schema": { "type": "string" }, "examples": { "error": { "value": "Invalid license key or location missing." } } } } }, "402": { "description": "API key not found.", "content": { "text/plain": { "schema": { "type": "string" }, "examples": { "error": { "value": "API key not found." } } } } }, "403": { "description": "Insufficient API credits remaining.", "content": { "text/plain": { "schema": { "type": "string" }, "examples": { "error": { "value": "Insufficient API credits remaining." } } } } }, "405": { "description": "Method not allowed.", "content": { "text/plain": { "schema": { "type": "string" }, "examples": { "error": { "value": "Method not allowed." } } } } }, "429": { "description": "Rate limits reached.", "content": { "text/plain": { "schema": { "type": "string" }, "examples": { "error": { "value": "Rate limits reached." } } } } }, "500": { "description": "Internal server error.", "content": { "text/plain": { "schema": { "type": "string" }, "examples": { "error": { "value": "Internal server error." } } } } } } } } }, "components": { "securitySchemes": { "apiKeyAuth": { "type": "apiKey", "name": "license", "in": "query" } }, "schemas": {} }, "security": [ { "apiKeyAuth": [] } ] }