openapi: 3.1.0
info:
  title: Durani Technologies Information API
  description: |
    This API provides structured information about Durani Technologies Inc.
    for AI agents, automated systems, and developers.

    ## About Durani Technologies

    Durani Technologies is a software development company founded in 1999 in Uruguay.
    We specialize in web development, mobile applications, cloud software, and AI integration.
    Our flagship service is **Durani AX™** (Agent Experience Optimization).

    ## Free Tools

    - **AX Audit Tool** - Free website AI readiness analyzer at `/ax-audit`
    - **AX Audit API** - Programmatic access at `/api/ax-audit` (POST)

    ## Available Endpoints

    - `/api/company` - **JSON API** returning complete company data (recommended for agents)
    - `/api/ax-audit` - **POST API** to audit any website's AI readiness (free)
    - `/llms.txt` - Basic information in plain text
    - `/llms-full.md` - Detailed documentation in markdown
    - `/.well-known/ai-plugin.json` - Plugin manifest
    - `/.well-known/agents.json` - Autonomous agent discovery manifest

  version: 2.0.0
  contact:
    name: Durani Technologies
    url: https://durani.tech/contact
  license:
    name: Proprietary
    url: https://durani.tech/terms

servers:
  - url: https://durani.tech
    description: Main website
  - url: https://api.lucioduran.com
    description: Data API

paths:
  /api/company:
    get:
      operationId: getCompanyData
      summary: Get complete company data as JSON (recommended)
      description: |
        Returns structured JSON data about Durani Technologies including services, products,
        expertise, statistics, and AI agent resources. This is the recommended endpoint for
        AI agents seeking structured company information. CORS enabled.
      responses:
        '200':
          description: Complete company data in Schema.org format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Company'
      tags:
        - API
        - AI Agent

  /api/ax-audit:
    post:
      operationId: runAxAudit
      summary: Run free AX Audit on any website
      description: |
        Analyzes any website's AI readiness with 16 automated tests.
        Returns an AX score (0-100), letter grade (A+ to F), detailed test results,
        and actionable recommendations.

        **Tests include:** llms.txt, llms-full.md, ai-plugin.json, agents.json,
        robots.txt, AI bots in robots.txt, sitemap.xml, OpenAPI spec, JSON-LD
        structured data, Open Graph tags, Twitter Cards, meta description,
        semantic HTML, H1 heading, and more.

        **Free** - No signup or authentication required. CORS enabled.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AXAuditRequest'
      responses:
        '200':
          description: Audit results with score, grade, test details, and recommendations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AXAuditResponse'
        '400':
          description: Invalid URL provided
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: "Invalid URL provided"
      tags:
        - Free Tools
        - API

  /ax-audit:
    get:
      operationId: getAxAuditTool
      summary: Free AX Audit Tool web interface
      description: |
        Web-based interface for the free AX Audit Tool. Enter any URL to analyze
        its AI readiness. Returns an AX score (0-100), grade (A+ to F), and
        detailed recommendations for optimizing the site for AI agents.
      responses:
        '200':
          description: AX Audit Tool page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Free Tools

  /llms.txt:
    get:
      operationId: getLlmsTxt
      summary: Get AI agent information file
      description: Returns structured information about Durani Technologies for AI agents in plain text (llms.txt standard v2.0.0)
      responses:
        '200':
          description: AI agent information file
          content:
            text/plain:
              schema:
                type: string
                example: "# Durani Technologies Inc. - AI Agent Information File..."
      tags:
        - AI Agent

  /llms-full.md:
    get:
      operationId: getLlmsFullMd
      summary: Get comprehensive AI documentation
      description: Returns detailed markdown documentation for AI agents with complete service details, methodologies, and technologies
      responses:
        '200':
          description: Comprehensive documentation
          content:
            text/markdown:
              schema:
                type: string
      tags:
        - AI Agent

  /.well-known/ai-plugin.json:
    get:
      operationId: getAiPlugin
      summary: Get AI plugin manifest
      description: Returns the AI plugin manifest for ChatGPT-style plugin discovery
      responses:
        '200':
          description: AI plugin manifest
          content:
            application/json:
              schema:
                type: object
      tags:
        - AI Agent

  /.well-known/agents.json:
    get:
      operationId: getAgentsJson
      summary: Get autonomous agent discovery manifest
      description: Returns the agents.json manifest for autonomous AI agent discovery, capabilities, and service routing
      responses:
        '200':
          description: Agent discovery manifest
          content:
            application/json:
              schema:
                type: object
      tags:
        - AI Agent

  /services:
    get:
      operationId: getServices
      summary: Get list of all 7 services (HTML)
      description: |
        Returns information about all services offered by Durani Technologies.
        The flagship service is Durani AX™ (Agent Experience Optimization).
        For structured JSON data, use /api/company instead.

        **Services offered:**
        1. Durani AX™ (FLAGSHIP) - /services/durani-ax
        2. Durani TechPath - /services/durani-techpath
        3. Durani AI Partner - /services/durani-ai-partner
        4. Digital Transformation - /services/transformacion-digital
        5. Mobile Apps - /services/desarrollo-aplicaciones-moviles-nativas
        6. Web Development - /services/sitios-web
        7. Cloud Software - /services/desarrollo-de-software-en-la-nube
      responses:
        '200':
          description: Services list page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /services/durani-ax:
    get:
      operationId: getDuraniAx
      summary: Get Durani AX™ service details (FLAGSHIP)
      description: |
        Returns detailed information about Durani AX™ - our flagship Agent Experience Optimization service.

        Durani AX™ optimizes websites for AI agents and LLMs (ChatGPT, Claude, Perplexity, etc.)
        using an 8-step methodology.

        **Key deliverables include:**
        - llms.txt implementation
        - JSON-LD Schema.org structured data
        - OpenAPI specifications
        - AI plugin manifests (.well-known/ai-plugin.json)
        - Autonomous agent discovery (agents.json)
        - Semantic HTML optimization
        - AI crawler configuration (robots.txt)
        - Validation with real AI systems

        **Technologies:** llms.txt, Schema.org, OpenAPI, JSON-LD, OpenAI, Anthropic, Perplexity, LangChain, Next.js, Vercel, React, TypeScript
      responses:
        '200':
          description: AX service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services
        - AI Agent

  /services/durani-techpath:
    get:
      operationId: getDuraniTechpath
      summary: Get Durani TechPath service details
      description: |
        Technology consulting service with 6-step methodology.
        Includes technology needs analysis, platform selection, architecture design,
        cost-benefit evaluation, and strategic roadmaps.
      responses:
        '200':
          description: TechPath service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /services/durani-ai-partner:
    get:
      operationId: getDuraniAiPartner
      summary: Get Durani AI Partner service details
      description: |
        AI integration and strategy service with 6-step methodology.
        LLM integration, custom AI solutions, model fine-tuning, and AI process automation.
        Technologies: OpenAI, Hugging Face, TensorFlow, PyTorch, LangChain, MLflow, AWS Bedrock, Google Vertex AI, Deepseek, Databricks, ONNX, Meta LLaMA.
      responses:
        '200':
          description: AI Partner service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /services/transformacion-digital:
    get:
      operationId: getDigitalTransformation
      summary: Get AI-Ready Digital Transformation service details
      description: |
        Digital transformation consulting with 10-step methodology.
        Process automation, legacy modernization, AI readiness, and data integration.
        Technologies: UIPath, IFTTT, Make, ChatGPT, Deepseek, Google Gemini, Looker Studio, BigQuery, Snowflake, Notion, Slack.
      responses:
        '200':
          description: Digital Transformation service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /services/desarrollo-aplicaciones-moviles-nativas:
    get:
      operationId: getMobileApps
      summary: Get Native Mobile App Development service details
      description: |
        Native mobile app development for iOS and Android with 10-step methodology.
        Technologies: React Native, TypeScript, Expo, Firebase, Redux, GraphQL, Supabase, Jest, Fastlane, Tanstack Query.
      responses:
        '200':
          description: Mobile Apps service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /services/sitios-web:
    get:
      operationId: getWebDevelopment
      summary: Get Responsive Web Development service details
      description: |
        Mobile-first responsive web development with 6-step methodology.
        Technologies: React, Next.js, Vue, Remix, Tailwind CSS, Figma, Laravel, Node.js, GraphQL, MongoDB, MySQL, PostgreSQL.
      responses:
        '200':
          description: Web Development service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /services/desarrollo-de-software-en-la-nube:
    get:
      operationId: getCloudSoftware
      summary: Get Cloud Software Development service details
      description: |
        Scalable cloud-native software with 10-step methodology.
        Technologies: Vercel, AWS, Google Cloud, Kubernetes, Docker, TypeScript, Node.js, MongoDB, GraphQL, DynamoDB, Lambda, CloudFront.
      responses:
        '200':
          description: Cloud Software service details page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Services

  /products:
    get:
      operationId: getProducts
      summary: Get list of products (HTML)
      description: Returns information about products developed by Durani Technologies. For structured JSON data, use /api/company instead.
      responses:
        '200':
          description: Products list page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Products

  /contact:
    get:
      operationId: getContact
      summary: Get contact information
      description: Returns contact form and information. Available in English and Spanish. Response time 24-48 hours.
      responses:
        '200':
          description: Contact page
          content:
            text/html:
              schema:
                type: string
      tags:
        - Contact

components:
  schemas:
    AXAuditRequest:
      type: object
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          description: The website URL to audit for AI readiness
          example: "https://example.com"

    AXAuditResponse:
      type: object
      properties:
        score:
          type: integer
          minimum: 0
          maximum: 100
          description: Overall AX score (0-100)
          example: 75
        grade:
          type: string
          description: Letter grade from A+ to F
          example: "B"
        url:
          type: string
          format: uri
          description: The URL that was audited
        tests:
          type: array
          description: Detailed results for each of the 16 tests
          items:
            type: object
            properties:
              name:
                type: string
                description: Test name
              passed:
                type: boolean
                description: Whether the test passed
              details:
                type: string
                description: Additional context about the test result
        recommendations:
          type: array
          description: Actionable recommendations for improvement
          items:
            type: string

    Service:
      type: object
      properties:
        '@type':
          type: string
          example: Service
        serviceType:
          type: string
          description: Category of service
        name:
          type: string
          description: Service name
        description:
          type: string
          description: Service description
        url:
          type: string
          format: uri
          description: Service page URL
        isFlagship:
          type: boolean
          description: Whether this is the flagship service
        methodologySteps:
          type: integer
          description: Number of steps in the service methodology
        technologies:
          type: array
          items:
            type: string
          description: Technologies used in this service
      example:
        '@type': Service
        serviceType: AI Agent Optimization
        name: Durani AX™ - Agent Experience Optimization
        description: Optimize your website for AI agents. Implement llms.txt, JSON-LD structured data, and semantic markup for accurate AI representation.
        url: https://durani.tech/services/durani-ax
        isFlagship: true
        methodologySteps: 8

    Product:
      type: object
      properties:
        '@type':
          type: string
          example: SoftwareApplication
        name:
          type: string
        description:
          type: string
        operatingSystem:
          type: string
        url:
          type: string
          format: uri
        downloadUrl:
          type: string
          format: uri
        offers:
          type: object
          properties:
            price:
              type: string
            priceCurrency:
              type: string
      example:
        '@type': SoftwareApplication
        name: Whateren
        description: iOS home inventory management app
        operatingSystem: iOS
        url: https://durani.tech/products/whateren
        downloadUrl: https://apps.apple.com/us/app/whateren-what-where-when/id6758481358

    Company:
      type: object
      properties:
        '@context':
          type: string
        '@type':
          type: array
          items:
            type: string
        name:
          type: string
        url:
          type: string
          format: uri
        foundingDate:
          type: string
        services:
          type: array
          items:
            $ref: '#/components/schemas/Service'
        products:
          type: array
          items:
            $ref: '#/components/schemas/Product'
        freeTools:
          type: array
          description: Free tools offered by Durani Technologies
          items:
            type: object
        statistics:
          type: object
          properties:
            yearsExperience:
              type: integer
            projectsCompleted:
              type: string
            clientsServed:
              type: string
        aiAgentResources:
          type: object
          description: URLs for AI agent discovery files
          properties:
            llmsTxt:
              type: string
              format: uri
            agentsJson:
              type: string
              format: uri
            aiPlugin:
              type: string
              format: uri
            axAuditApi:
              type: string
              format: uri

tags:
  - name: API
    description: JSON API endpoints (recommended for AI agents)
  - name: AI Agent
    description: Endpoints and files optimized for AI agents and automated systems
  - name: Free Tools
    description: Free tools available to anyone without signup
  - name: Services
    description: Information about technology services (7 services)
  - name: Products
    description: Information about software products
  - name: Contact
    description: Contact and communication

externalDocs:
  description: Full documentation at llms-full.md
  url: https://durani.tech/llms-full.md
