Universal Gateway Request

The Universal Gateway is the simplest way to interact with multiple APIs through natural language. Send one request and let Solariz route it intelligently to the most relevant APIs in our ecosystem.

How the Universal Gateway Works

Solariz creates a seamless bridge between AI agents and existing REST APIs. Here's how it processes your requests:

Process Natural Language

Send queries to SOLARIZ. Our NLP engine routes them to the appropriate endpoints in clusters.

💡 Example: What's the weather in Paris and give me the next flight from London to Paris?

Intelligent Routing

Solariz routes requests intelligently via natural language to the most relevant APIs.

💡 Example: Routes to weather API for Paris weather, flights API for London-Paris flights

Structured Responses

Get human-readable responses and structured data in one request. Perfect for UI display and data processing.

💡 Example: Combined weather data + flights information

Key Benefits

The Universal Gateway eliminates complexity and makes API integration effortless:

No Custom Coding Required

Enable AI agents to interact with your APIs through natural language without writing custom integrations

Seamless Bridge

Creates a seamless bridge between AI agents and your existing REST APIs

Automatic Translation

Handles the translation and routing automatically, making APIs instantly accessible to AI agents

Multiple Services

Connect multiple services together, then interact with all of them using simple natural language

Example Request & Response

Here's how to make a Universal Gateway request:

Request

curl -X POST https://api.solariz.ai/v1/public/universal-gateway \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{
    "query": "What is the weather like in London?",
    "queryType": "SIMPLE"
  }'

Response

{
  "routingInfo": {
    "success": true,
    "reasoning": "Weather query detected - routing to weather API cluster for London weather information.",
    "cluster_id": "weather-cluster-001",
    "cluster_name": "Weather Information Services",
    "confidence_score": 0.98,
    "processing_time_seconds": 0.245,
    "error_message": null
  },
  "queryResult": {
    "formatted_response": "The weather in London on June 9, 2025, is partly cloudy with a temperature of 16°C. The wind is coming from the west-southwest at 13 km/h. The humidity is 72%, and there is no precipitation. The air quality index indicates moderate levels of pollutants. Sunrise was at 4:44 AM, and sunset will be at 9:16 PM.",
    "raw_response": [
      {
            "status_code": 200,
            "body": {
                  "request": {
                        "type": "City",
                        "query": "London, United Kingdom",
                        "language": "en",
                        "unit": "m"
                  },
                  "location": {
                        "name": "London",
                        "country": "United Kingdom",
                        "region": "City of London, Greater London",
                        "lat": "51.517",
                        "lon": "-0.106",
                        "timezone_id": "Europe/London",
                        "localtime": "2025-06-09 10:06",
                        "localtime_epoch": 1749463560,
                        "utc_offset": "1.0"
                  },
                  "current": {
                        "observation_time": "09:06 AM",
                        "temperature": 16,
                        "weather_code": 116,
                        "weather_icons": [
                              "https://cdn.worldweatheronline.com/images/wsymbols01_png_64/wsymbol_0002_sunny_intervals.png"
                        ],
                        "weather_descriptions": [
                              "Partly cloudy"
                        ],
                        "astro": {
                              "sunrise": "04:44 AM",
                              "sunset": "09:16 PM",
                              "moonrise": "08:09 PM",
                              "moonset": "03:00 AM",
                              "moon_phase": "Waxing Gibbous",
                              "moon_illumination": 95
                        },
                        "air_quality": {
                              "co": "370",
                              "no2": "25.715",
                              "o3": "65",
                              "so2": "2.405",
                              "pm2_5": "24.42",
                              "pm10": "30.71",
                              "us-epa-index": "2",
                              "gb-defra-index": "2"
                        },
                        "wind_speed": 13,
                        "wind_degree": 243,
                        "wind_dir": "WSW",
                        "pressure": 1022,
                        "precip": 0,
                        "humidity": 72,
                        "cloudcover": 50,
                        "feelslike": 16,
                        "uv_index": 3,
                        "visibility": 10,
                        "is_day": "yes"
                  }
            },
            "endpoint": "/current"
      }
],
    "api_used": "Weather API",
    "endpoints_used": "/current",
    "status_code": 200,
    "success": true
  }
}

🎯 Smart Routing in Action

The query automatically triggers the weather API based on natural language understanding. Solariz intelligently routes to the most relevant service and returns both human-readable and structured data — all without any manual setup.

Ready to Try the Universal Gateway?

Experience the power of natural language API routing firsthand. Visit our platform to start building with the Universal Gateway and see how simple API integration can be.

Try the Gateway Endpoint

Documentation