☁️ Cloud Region API

A read-only REST API for querying cloud provider region information.

Built with Xano for the DEV x Xano AI-Powered Backend Challenge.

This project provides a simple backend service for retrieving cloud region metadata across multiple cloud providers including AWS, Azure, and Google Cloud.

---

Tech Stack

• Xano Backend Platform
• REST API
• JSON
• Database Queries
• HTTP GET Methods
• GitHub Documentation

---

🚀 Features

• ✅ Read-only REST API
• ✅ Multi-cloud region database
• ✅ Provider-based filtering
• ✅ Specific region lookup
• ✅ Case-insensitive queries
• ✅ 404 handling for missing regions
• ✅ Simple API-first backend architecture
• ✅ JSON responses

---

🏗️ Architecture

Client
  |
  v
REST API (Xano)
  |
  v
Cloud Regions Database

The backend follows a lightweight API design:

• Cloud region data is stored in a database
• API endpoints provide read-only access
• No data modification operations are exposed

---

☁️ Supported Cloud Providers

Provider	Example Region Codes
AWS	us-east-1
Azure	westeurope
Google Cloud	europe-west1

---

📌 API Endpoints

Health Check

GET /health

Returns the current API service status.

Example response:

{
  "status": "ok",
  "service": "cloud-region-api"
}

---

Get All Cloud Regions

GET /regions

Returns all available cloud regions.

Example response:

[
  {
    "provider": "AWS",
    "region_code": "us-east-1",
    "location": "Virginia",
    "continent": "North America"
  }
]

---

Get Regions By Provider

GET /regions/{provider}

Returns all regions belonging to a specific cloud provider.

Example:

GET /regions/aws

Response:

[
  {
    "provider": "AWS",
    "region_code": "us-east-1",
    "location": "Virginia",
    "continent": "North America"
  }
]

---

Get Specific Region

GET /regions/{provider}/{region_code}

Returns a single cloud region matching the provider and region code.

Example:

GET /regions/aws/us-east-1

Response:

{
  "id": 1,
  "provider": "AWS",
  "region_code": "us-east-1",
  "location": "Virginia",
  "continent": "North America"
}

If the region does not exist:

{
  "error": "Cloud region not found"
}

---

🛠️ Tech Stack

Technology	Purpose
Xano	Backend platform
REST API	Service communication
JSON	Data format
Database	Region storage

---

🔒 Design Decisions

This API intentionally follows a read-only architecture.

Available:

✅ GET endpoints

Not available:

❌ POST
❌ PUT
❌ PATCH
❌ DELETE

The goal is to provide a reliable cloud region lookup service with a minimal backend footprint.

---

🧪 Testing

Endpoints were tested using the built-in Xano API testing environment.

Validated:

• Successful API responses
• Database queries
• Provider filtering
• Region lookup
• Missing resource handling

---

---

📸 Screenshots

Health Endpoint

---

Regions Endpoint

---

📚 Documentation

• Architecture
• API Reference

---

📦 Example Response

See:

• Sample JSON Response

---

🎯 Project Purpose

This project demonstrates:

• Backend API development
• Database-driven applications
• REST API design
• Cloud infrastructure concepts
• Multi-cloud terminology
• Backend automation workflows

---

👤 Author

Antonis Loukis

GitHub: https://github.com/antonisloukis