{ "openapi": "3.1.0", "info": { "title": "Interzoid Global Weather Info API", "description": "This API retrieves real-time weather information for a specified global location. It returns 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 including calling in high-performance batch mode, 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 real-time weather information for any location worldwide." } ], "paths": { "/getglobalweather": { "get": { "tags": [ "Global Weather Information" ], "summary": "Retrieve weather information for a location", "description": "Retrieves the current weather details for a specified location, including temperature, weather conditions, wind speed, and direction.\n**Note**: You must include your API key as the `license` parameter in the request. If you do not have an API key, you can register for one at [Interzoid Registration](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 the weather information is retrieved.", "schema": { "type": "string" }, "examples": { "location": { "summary": "Location Example", "value": "Madrid" } } } ], "responses": { "200": { "description": "Successful response containing 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." }, "WindDir": { "type": "string", "description": "Wind direction." }, "Code": { "type": "string", "description": "Response code." }, "Credits": { "type": "string", "description": "Remaining credits for your API license." } }, "examples": [ { "summary": "Successful response example", "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": { "application/json": { "schema": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } }, "examples": [ { "summary": "Missing or invalid parameters", "value": { "Code": 400, "Message": "Invalid license key or location missing." } } ] } } } }, "402": { "description": "API key not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } }, "examples": [ { "summary": "API key not found", "value": { "Code": 402, "Message": "API key not found." } } ] } } } }, "403": { "description": "Insufficient API credits remaining.", "content": { "application/json": { "schema": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } }, "examples": [ { "summary": "Insufficient credits", "value": { "Code": 403, "Message": "Insufficient API credits remaining." } } ] } } } }, "405": { "description": "Method not allowed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } }, "examples": [ { "summary": "Wrong HTTP method", "value": { "Code": 405, "Message": "Method not allowed." } } ] } } } }, "429": { "description": "Rate limits reached.", "content": { "application/json": { "schema": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } }, "examples": [ { "summary": "Rate limit reached", "value": { "Code": 429, "Message": "Rate limits reached." } } ] } } } }, "500": { "description": "Internal server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } }, "examples": [ { "summary": "Server error", "value": { "Code": 500, "Message": "Internal server error." } } ] } } } } } } } }, "components": { "securitySchemes": { "apiKeyAuth": { "type": "apiKey", "name": "license", "in": "query" } }, "schemas": { "ResponseError": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Response code." }, "Message": { "type": "string", "description": "Error message." } } } } }, "security": [ { "apiKeyAuth": [] } ] }