{
  "openapi": "3.2.0",
  "info": {
    "title": "Mahmoud Zalt - Portfolio API",
    "description": "API for accessing Mahmoud Zalt's portfolio, services, blog posts, and professional information. This site is available in both English and Arabic. Arabic pages are prefixed with /ar/. This API does not collect personal information. For privacy information, see: https://zalt.me/privacy",
    "version": "1.0.0",
    "contact": {
      "name": "Mahmoud Zalt",
      "email": "contact@zalt.me",
      "url": "https://zalt.me"
    },
    "termsOfService": "https://zalt.me/privacy"
  },
  "servers": [
    {
      "url": "https://zalt.me",
      "description": "Production server"
    }
  ],
  "paths": {
    "/data/projects.json": {
      "get": {
        "summary": "Get all projects",
        "description": "Retrieve a list of all portfolio projects including open-source work, client projects, and personal projects.",
        "operationId": "getProjects",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "technologies": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "type": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "images": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/services.json": {
      "get": {
        "summary": "Get all services",
        "description": "Retrieve information about available services including fractional CTO, technical consulting, career mentoring, life coaching, and public speaking. Each service includes detailed process information (phases, duration, deliverables) showing how the service is delivered.",
        "operationId": "getServices",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "available": {
                        "type": "boolean"
                      },
                      "category": {
                        "type": "string"
                      },
                      "primary": {
                        "type": "boolean"
                      },
                      "image": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string"
                      },
                      "details": {
                        "type": "string",
                        "description": "Detailed service description"
                      },
                      "benefitsTitle": {
                        "type": "string"
                      },
                      "benefitsDescription": {
                        "type": "string"
                      },
                      "benefits": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string"
                            },
                            "description": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "ctaTitle": {
                        "type": "string"
                      },
                      "ctaDescription": {
                        "type": "string"
                      },
                      "ctaButtonText": {
                        "type": "string"
                      },
                      "ctaButtonHref": {
                        "type": "string"
                      },
                      "ctaSecondaryButtonText": {
                        "type": "string"
                      },
                      "ctaSecondaryButtonHref": {
                        "type": "string"
                      },
                      "ctaShowTrustIndicators": {
                        "type": "boolean"
                      },
                      "showSuccessStories": {
                        "type": "boolean"
                      },
                      "successStories": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string"
                            },
                            "description": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "pricing": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "custom",
                              "hourly",
                              "project",
                              "retainer",
                              "equity",
                              "contact"
                            ]
                          },
                          "amount": {
                            "type": "string"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "note": {
                            "type": "string"
                          }
                        }
                      },
                      "process": {
                        "type": "object",
                        "description": "Detailed process information showing how the service is delivered, including phases, duration, and deliverables.",
                        "properties": {
                          "title": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "phases": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "phase": {
                                  "type": "number"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string"
                                },
                                "description": {
                                  "type": "string"
                                },
                                "duration": {
                                  "type": "string"
                                },
                                "deliverables": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              },
                              "required": [
                                "phase",
                                "name",
                                "title",
                                "description"
                              ]
                            }
                          }
                        },
                        "required": [
                          "title",
                          "phases"
                        ]
                      },
                      "availabilityStatus": {
                        "type": "string",
                        "description": "Current availability status text (e.g., \"Available\", \"Limited Availability\", \"Contact for Arrangement\", etc.)"
                      }
                    },
                    "required": [
                      "title",
                      "description",
                      "slug",
                      "available"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/feed.json": {
      "get": {
        "summary": "Get blog posts feed",
        "description": "Retrieve blog posts and articles in JSON Feed format.",
        "operationId": "getBlogPosts",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": {
                            "type": "string"
                          },
                          "content_html": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          },
                          "date_published": {
                            "type": "string"
                          },
                          "image": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/about.json": {
      "get": {
        "summary": "Get about information",
        "description": "Retrieve professional background, experience, expertise areas, and biographical information in structured JSON format.",
        "operationId": "getAbout",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "shortTitle": {
                      "type": "string"
                    },
                    "experienceYears": {
                      "type": "string"
                    },
                    "location": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "city": {
                            "type": "string"
                          },
                          "country": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "bio": {
                      "type": "string"
                    },
                    "fullBio": {
                      "type": "string"
                    },
                    "expertise": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "contact": {
                      "type": "object",
                      "properties": {
                        "email": {
                          "type": "string"
                        },
                        "phone": {
                          "type": "string"
                        },
                        "website": {
                          "type": "string"
                        }
                      }
                    },
                    "social": {
                      "type": "object",
                      "description": "Social media and professional profile links",
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/testimonials.json": {
      "get": {
        "summary": "Get testimonials",
        "description": "Retrieve client testimonials and reviews including ratings, service labels, and detailed feedback from various services.",
        "operationId": "getTestimonials",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "@type": {
                        "type": "string",
                        "example": "Review"
                      },
                      "author": {
                        "type": "object",
                        "properties": {
                          "@type": {
                            "type": "string",
                            "example": "Person"
                          },
                          "name": {
                            "type": "string"
                          },
                          "jobTitle": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "@type",
                          "name",
                          "jobTitle"
                        ]
                      },
                      "reviewBody": {
                        "type": "string"
                      },
                      "reviewRating": {
                        "type": "object",
                        "properties": {
                          "@type": {
                            "type": "string",
                            "example": "Rating"
                          },
                          "ratingValue": {
                            "type": "string"
                          },
                          "bestRating": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "@type",
                          "ratingValue",
                          "bestRating"
                        ]
                      },
                      "serviceLabel": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "@type",
                      "author",
                      "reviewBody",
                      "reviewRating",
                      "serviceLabel"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/contact.json": {
      "get": {
        "summary": "Get contact information",
        "description": "Retrieve contact information including email, phone, WhatsApp, scheduling links, location details, and available languages.",
        "operationId": "getContact",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "email": {
                      "type": "string",
                      "format": "email"
                    },
                    "phone": {
                      "type": "string"
                    },
                    "phoneFormatted": {
                      "type": "string"
                    },
                    "whatsappUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "contactUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "aboutUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "availableLanguages": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "language": {
                      "type": "string"
                    },
                    "areaServed": {
                      "type": "string"
                    },
                    "contactScheduleCallUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "contactMapUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "location": {
                      "type": "object",
                      "properties": {
                        "city": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "personalCity": {
                          "type": "string"
                        },
                        "personalCountry": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "city",
                        "country",
                        "personalCity",
                        "personalCountry"
                      ]
                    }
                  },
                  "required": [
                    "email",
                    "phone",
                    "contactUrl",
                    "location"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/data/tools.json": {
      "get": {
        "summary": "Get free AI tools",
        "description": "List of all free AI tools available on the site. Each tool runs entirely in the browser with no server or signup required.",
        "operationId": "getTools",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "short": {
                        "type": "string"
                      },
                      "path": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "tags": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "features": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "rating": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "string"
                          },
                          "count": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "required": [
                      "id",
                      "title",
                      "description",
                      "path",
                      "url"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/data/index.json": {
      "get": {
        "summary": "Get API index",
        "description": "Machine-readable index of all available JSON API endpoints. Use this to discover all available endpoints programmatically.",
        "operationId": "getApiIndex",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "version": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "baseUrl": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "endpoints": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string",
                            "enum": [
                              "core",
                              "blog",
                              "feeds",
                              "metadata",
                              "specs",
                              "main-pages",
                              "docs-policies",
                              "site-files",
                              "misc"
                            ]
                          },
                          "method": {
                            "type": "string"
                          },
                          "contentType": {
                            "type": "string"
                          },
                          "example": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "categories": {
                      "type": "object"
                    },
                    "totalEndpoints": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}