{
  "openapi": "3.0.3",
  "info": {
    "title": "Mawaqit Salat Tripoli API",
    "description": "Official prayer times API for Tripoli & El-Mina, Lebanon, based on Al-Masjid Al-Aali Al-Kabir schedule and Lebanese Dar Al-Fatwa conventions.",
    "version": "1.0.0",
    "contact": {
      "name": "Hadi Abdallah",
      "url": "https://mawaqit.hadiabdallah.tech"
    }
  },
  "servers": [
    {
      "url": "https://mawaqit.hadiabdallah.tech",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/api/prayer-times": {
      "get": {
        "summary": "Get today's and tomorrow's prayer times for Tripoli, Lebanon",
        "description": "Returns live prayer times (Fajr, Shuruq, Dhuhr, Asr, Maghrib, Isha) for Tripoli and El-Mina. Automatically switches to next day's times after Isha prayer.",
        "operationId": "getPrayerTimes",
        "responses": {
          "200": {
            "description": "Successful prayer times response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "mosqueName": {
                      "type": "string",
                      "example": "المسجد العالي الكبير -الميناء-"
                    },
                    "city": {
                      "type": "string",
                      "example": "طرابلس"
                    },
                    "fajr": {
                      "type": "string",
                      "example": "04:26"
                    },
                    "shuruq": {
                      "type": "string",
                      "example": "05:50"
                    },
                    "dhuhr": {
                      "type": "string",
                      "example": "11:23"
                    },
                    "asr": {
                      "type": "string",
                      "example": "14:27"
                    },
                    "maghrib": {
                      "type": "string",
                      "example": "16:55"
                    },
                    "isha": {
                      "type": "string",
                      "example": "18:14"
                    },
                    "dayName": {
                      "type": "string",
                      "example": "الأحد"
                    },
                    "gregorianDate": {
                      "type": "string",
                      "example": "25 تشرين الأول 2026"
                    },
                    "hijriDate": {
                      "type": "string",
                      "example": "14 جمادى الأولى 1448"
                    },
                    "isNextDay": {
                      "type": "boolean",
                      "example": false
                    },
                    "prayerTimes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "example": "الفجر"
                          },
                          "time": {
                            "type": "string",
                            "example": "04:26"
                          },
                          "icon": {
                            "type": "string",
                            "example": "🌅"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/prayer-data.json": {
      "get": {
        "summary": "Full 365-day annual prayer calendar dataset",
        "description": "Returns the complete 12-month calendar of prayer timings for Tripoli, Lebanon.",
        "operationId": "getAnnualCalendar",
        "responses": {
          "200": {
            "description": "Full calendar JSON array (12 months of daily prayer arrays)"
          }
        }
      }
    }
  }
}