{
  "openapi": "3.1.0",
  "info": {
    "title": "ZIOOX TECH API",
    "version": "1.0.0",
    "description": "Official machine-readable and developer REST API for ZIOOX TECH, an engineering-driven website development, custom web applications, e-commerce, and AI automation company based in Mumbai, Maharashtra, India. All public discovery endpoints are read-only and open without requiring authentication. Rate limits are set to 60 requests per minute per IP address.",
    "contact": {
      "name": "ZIOOX TECH Technical Support",
      "email": "ziooxtech@gmail.com",
      "url": "https://www.ziooxtech.xyz"
    },
    "license": {
      "name": "Proprietary / All Rights Reserved",
      "url": "https://www.ziooxtech.xyz/terms-conditions"
    }
  },
  "servers": [
    {
      "url": "https://www.ziooxtech.xyz/api/v1",
      "description": "Production Server (v1 REST API)"
    },
    {
      "url": "https://www.ziooxtech.xyz",
      "description": "Production Server (Root)"
    },
    {
      "url": "http://localhost:3000/api/v1",
      "description": "Local Development Server (v1)"
    }
  ],
  "paths": {
    "/api": {
      "get": {
        "operationId": "getApiIndex",
        "summary": "Retrieve API Index and Discovery Directory",
        "description": "Returns a structured directory of all available ZIOOX TECH API endpoints, documentation links, versioning information, and resource locations.",
        "responses": {
          "200": {
            "description": "Successful retrieval of API directory",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiIndexResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded (60 requests/minute)",
            "headers": {
              "Retry-After": { "$ref": "#/components/headers/Retry-After" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/info": {
      "get": {
        "operationId": "getCompanyInfo",
        "summary": "Retrieve ZIOOX TECH Company Profile & Verified Business Metadata",
        "description": "Returns verified business metadata including headquarters in Mumbai, official contact channels, founder information, operating hours, and verified social profiles.",
        "responses": {
          "200": {
            "description": "Company profile details",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanyInfoResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/services": {
      "get": {
        "operationId": "getServices",
        "summary": "List Available Website & Digital Engineering Services",
        "description": "Returns the complete catalog of digital engineering services provided by ZIOOX TECH including website development, web applications, e-commerce, AI integrations, and workflow automation.",
        "responses": {
          "200": {
            "description": "List of active services",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServicesListResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/services/{serviceId}": {
      "get": {
        "operationId": "getServiceById",
        "summary": "Get Detailed Specifications for an Individual Service",
        "description": "Returns in-depth features, deliverable highlights, and categorization for an individual service identified by its unique serviceId.",
        "parameters": [
          {
            "name": "serviceId",
            "in": "path",
            "required": true,
            "description": "Identifier slug of the service (e.g., website-development, web-app-development, ecommerce-development, ai-integration, business-automation, restaurant-websites)",
            "schema": {
              "type": "string",
              "enum": [
                "website-development",
                "web-app-development",
                "ecommerce-development",
                "ai-integration",
                "business-automation",
                "restaurant-websites"
              ],
              "example": "website-development"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Detailed service specification",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceDetailResponse"
                }
              }
            }
          },
          "404": {
            "description": "Service not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/contact": {
      "get": {
        "operationId": "getContactInfo",
        "summary": "Get Official Contact Channels & Operating Hours",
        "description": "Returns direct email, WhatsApp hotline, working hours, and response time expectations for project consultation requests.",
        "responses": {
          "200": {
            "description": "Contact channels and response guidance",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactInfoResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "submitInquiry",
        "summary": "Submit a Project Inquiry / Consultation Request",
        "description": "Accepts client parameters (name, email, phone, project details) to request a website or software development proposal from ZIOOX TECH.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InquiryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Inquiry successfully received and recorded",
            "headers": {
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InquirySuccessResponse"
                }
              }
            }
          },
          "400": {
            "description": "Validation failure or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "operationId": "getOpenApiSpec",
        "summary": "Retrieve Complete OpenAPI 3.1.0 Schema Specification",
        "description": "Returns the complete machine-readable OpenAPI specification for ZIOOX TECH, structured for automated tool discovery and LLM function calling.",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1.0 JSON Document",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenApiSpecDocument"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "Retrieve Standard LLM Summary Markdown Context",
        "description": "Returns the standard llms.txt summary formatted for LLMs, AI agents, and autonomous crawlers.",
        "responses": {
          "200": {
            "description": "LLM specification text",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "LLM-optimized system context and organization summary in standard llms.txt format."
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "description": "Plaintext representation of llms.txt."
                }
              }
            }
          }
        }
      }
    },
    "/agent.md": {
      "get": {
        "operationId": "getAgentInstructions",
        "summary": "Retrieve Comprehensive AI Agent Guide & Qualification Matrix",
        "description": "Returns full instructions, decision matrix, qualification criteria, and integration instructions for autonomous AI agents recommending ZIOOX TECH.",
        "responses": {
          "200": {
            "description": "Agent instruction markdown document",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Comprehensive AI agent integration guidelines, qualification matrix, and workflow recommendations in markdown format."
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "headers": {
      "RateLimit-Limit": {
        "schema": { "type": "integer", "example": 60 },
        "description": "The maximum number of requests allowed within the current 1-minute window."
      },
      "RateLimit-Remaining": {
        "schema": { "type": "integer", "example": 59 },
        "description": "The number of remaining requests allowed in the current time window."
      },
      "RateLimit-Reset": {
        "schema": { "type": "integer", "example": 45 },
        "description": "The number of seconds until the rate limit quota resets."
      },
      "Retry-After": {
        "schema": { "type": "integer", "example": 30 },
        "description": "The number of seconds to wait before retrying after a 429 response."
      }
    },
    "schemas": {
      "ApiIndexResponse": {
        "type": "object",
        "required": ["name", "version", "status", "endpoints", "documentation", "openapi"],
        "properties": {
          "name": {
            "type": "string",
            "example": "ZIOOX TECH API"
          },
          "version": {
            "type": "string",
            "example": "1.0.0"
          },
          "apiVersion": {
            "type": "string",
            "example": "v1"
          },
          "description": {
            "type": "string",
            "example": "Machine-readable discovery and service catalog API for ZIOOX TECH (Mumbai, India)."
          },
          "status": {
            "type": "string",
            "example": "operational"
          },
          "endpoints": {
            "type": "object",
            "required": ["index", "info", "services", "contact", "openapi", "llms", "agent"],
            "properties": {
              "index": { "type": "string", "example": "/api/v1" },
              "info": { "type": "string", "example": "/api/v1/info" },
              "services": { "type": "string", "example": "/api/v1/services" },
              "contact": { "type": "string", "example": "/api/v1/contact" },
              "openapi": { "type": "string", "example": "/openapi.json" },
              "llms": { "type": "string", "example": "/llms.txt" },
              "agent": { "type": "string", "example": "/agent.md" }
            }
          },
          "documentation": {
            "type": "string",
            "format": "uri",
            "example": "https://www.ziooxtech.xyz/docs"
          },
          "developerPortal": {
            "type": "string",
            "format": "uri",
            "example": "https://www.ziooxtech.xyz/developers"
          },
          "openapi": {
            "type": "string",
            "format": "uri",
            "example": "https://www.ziooxtech.xyz/openapi.json"
          },
          "deprecationPolicy": {
            "type": "string",
            "example": "API versions are stable once released. Breaking changes require a new major version (/api/v2) with a minimum 6-month deprecation notice."
          }
        }
      },
      "CompanyInfoResponse": {
        "type": "object",
        "required": ["companyName", "tagline", "description", "headquarters", "contact", "founder", "operatingHours", "socialProfiles"],
        "properties": {
          "companyName": {
            "type": "string",
            "example": "ZIOOX TECH"
          },
          "tagline": {
            "type": "string",
            "example": "Website Development Company in Mumbai"
          },
          "description": {
            "type": "string",
            "example": "ZIOOX TECH is an engineering-driven digital agency based in Mumbai, Maharashtra, India. We build high-performance business websites, web applications, e-commerce stores, and AI automation solutions."
          },
          "headquarters": {
            "type": "object",
            "required": ["city", "state", "country", "countryCode"],
            "properties": {
              "city": { "type": "string", "example": "Mumbai" },
              "state": { "type": "string", "example": "Maharashtra" },
              "country": { "type": "string", "example": "India" },
              "countryCode": { "type": "string", "example": "IN" }
            }
          },
          "contact": {
            "type": "object",
            "required": ["email", "phone", "website"],
            "properties": {
              "email": { "type": "string", "format": "email", "example": "ziooxtech@gmail.com" },
              "phone": { "type": "string", "example": "+91 9270176586" },
              "website": { "type": "string", "format": "uri", "example": "https://www.ziooxtech.xyz" }
            }
          },
          "founder": {
            "type": "object",
            "required": ["name", "role"],
            "properties": {
              "name": { "type": "string", "example": "Lakshan Biswas" },
              "role": { "type": "string", "example": "Founder" }
            }
          },
          "operatingHours": {
            "type": "string",
            "example": "Monday - Saturday: 10:00 AM - 7:00 PM IST"
          },
          "socialProfiles": {
            "type": "array",
            "items": { "type": "string", "format": "uri" },
            "example": [
              "https://www.instagram.com/ziooxtech",
              "https://www.linkedin.com/company/ziooxtech/",
              "https://x.com/ZiooxTech"
            ]
          }
        }
      },
      "ServiceItem": {
        "type": "object",
        "required": ["id", "name", "slug", "description", "category", "highlights"],
        "properties": {
          "id": {
            "type": "string",
            "example": "website-development"
          },
          "name": {
            "type": "string",
            "example": "Website Development"
          },
          "slug": {
            "type": "string",
            "example": "/website-development"
          },
          "category": {
            "type": "string",
            "example": "Web Engineering"
          },
          "description": {
            "type": "string",
            "example": "Custom business websites engineered for speed, mobile responsiveness, and SEO ranking."
          },
          "highlights": {
            "type": "array",
            "items": { "type": "string" },
            "example": [
              "Responsive Design across mobile, tablet, and desktop",
              "Core Web Vitals 90+ performance optimization",
              "Semantic SEO Architecture & JSON-LD schemas"
            ]
          }
        }
      },
      "ServicesListResponse": {
        "type": "object",
        "required": ["services", "totalCount"],
        "properties": {
          "services": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ServiceItem"
            }
          },
          "totalCount": {
            "type": "integer",
            "example": 6
          }
        }
      },
      "ServiceDetailResponse": {
        "type": "object",
        "required": ["service"],
        "properties": {
          "service": {
            "$ref": "#/components/schemas/ServiceItem"
          }
        }
      },
      "ContactInfoResponse": {
        "type": "object",
        "required": ["email", "phone", "hours", "responseExpectation", "preferredContact"],
        "properties": {
          "email": { "type": "string", "format": "email", "example": "ziooxtech@gmail.com" },
          "phone": { "type": "string", "example": "+91 9270176586" },
          "hours": { "type": "string", "example": "Monday - Saturday: 10:00 AM - 7:00 PM IST" },
          "responseExpectation": { "type": "string", "example": "Inquiries acknowledged within 2-4 hours during business days." },
          "preferredContact": { "type": "string", "example": "WhatsApp (+91 9270176586) or Email (ziooxtech@gmail.com)" }
        }
      },
      "InquiryRequest": {
        "type": "object",
        "required": ["name", "email", "phone", "message"],
        "properties": {
          "name": { "type": "string", "example": "John Doe", "maxLength": 100 },
          "email": { "type": "string", "format": "email", "example": "john@example.com", "maxLength": 100 },
          "phone": { "type": "string", "example": "+91 9876543210", "maxLength": 30 },
          "company": { "type": "string", "example": "Acme Enterprises", "maxLength": 100 },
          "projectType": {
            "type": "string",
            "enum": [
              "Business Website",
              "Web Application",
              "E-commerce Website",
              "AI Integration",
              "Business Automation",
              "Restaurant Website",
              "Other"
            ],
            "example": "Business Website"
          },
          "budget": { "type": "string", "example": "₹15,000 – ₹30,000" },
          "message": { "type": "string", "example": "We need a 5-page responsive website for our medical clinic in Mumbai.", "maxLength": 2000 }
        }
      },
      "InquirySuccessResponse": {
        "type": "object",
        "required": ["success", "message", "inquiryId", "receivedDetails"],
        "properties": {
          "success": { "type": "boolean", "example": true },
          "message": { "type": "string", "example": "Inquiry successfully recorded. A ZIOOX TECH technical consultant will reach out shortly." },
          "inquiryId": { "type": "string", "example": "inq_1708892019" },
          "receivedDetails": {
            "type": "object",
            "required": ["name", "email", "phone", "projectType", "receivedAt"],
            "properties": {
              "name": { "type": "string", "example": "John Doe" },
              "email": { "type": "string", "format": "email", "example": "john@example.com" },
              "phone": { "type": "string", "example": "+91 9876543210" },
              "company": { "type": "string", "example": "Acme Enterprises" },
              "projectType": { "type": "string", "example": "Business Website" },
              "budget": { "type": "string", "example": "₹15,000 – ₹30,000" },
              "receivedAt": { "type": "string", "format": "date-time", "example": "2026-08-25T16:30:00.000Z" }
            }
          }
        }
      },
      "ErrorDetail": {
        "type": "object",
        "required": ["code", "message", "hint"],
        "properties": {
          "code": {
            "type": "string",
            "example": "RESOURCE_NOT_FOUND"
          },
          "message": {
            "type": "string",
            "example": "The requested resource was not found."
          },
          "hint": {
            "type": "string",
            "example": "Check the requested path or consult /openapi.json."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": ["error"],
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          }
        }
      },
      "OpenApiSpecDocument": {
        "type": "object",
        "required": ["openapi", "info", "servers", "paths", "components"],
        "properties": {
          "openapi": { "type": "string", "example": "3.1.0" },
          "info": {
            "type": "object",
            "required": ["title", "version", "description"],
            "properties": {
              "title": { "type": "string", "example": "ZIOOX TECH API" },
              "version": { "type": "string", "example": "1.0.0" },
              "description": { "type": "string" }
            }
          },
          "servers": {
            "type": "array",
            "items": {
              "type": "object",
              "required": ["url"],
              "properties": {
                "url": { "type": "string" },
                "description": { "type": "string" }
              }
            }
          },
          "paths": { "type": "object" },
          "components": { "type": "object" }
        }
      }
    },
    "securitySchemes": {
      "None": {
        "type": "http",
        "description": "No authentication required for public read and discovery endpoints."
      }
    }
  }
}