{
  "openapi": "3.1.0",
  "info": {
    "title": "Comturk Public Discovery API",
    "summary": "Read-only public feeds for Comturk pricing, products, integrations, service inventory, and availability.",
    "description": "This OpenAPI description exposes static, unauthenticated discovery endpoints for agents, crawlers, and procurement tools. It does not expose account management, booking, inventory reservation, or checkout operations.",
    "version": "2026-05-17",
    "contact": {
      "name": "Comturk Sales",
      "url": "https://comturk.com/company/contact.html"
    }
  },
  "servers": [
    {
      "url": "https://comturk.com",
      "description": "Comturk public website"
    }
  ],
  "tags": [
    {
      "name": "Discovery",
      "description": "Static public feeds intended for agents and crawlers."
    }
  ],
  "paths": {
    "/feeds/pricing.json": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getPricingFeed",
        "summary": "Get current public plan and pricing data",
        "responses": {
          "200": {
            "description": "Comturk pricing feed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PricingFeed"
                }
              }
            }
          }
        }
      }
    },
    "/feeds/products.json": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getProductCatalog",
        "summary": "Get public product catalog data",
        "responses": {
          "200": {
            "description": "Comturk product catalog feed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductFeed"
                }
              }
            }
          }
        }
      }
    },
    "/feeds/integrations.json": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getIntegrationsFeed",
        "summary": "Get channel and integration availability",
        "responses": {
          "200": {
            "description": "Comturk integrations feed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrationsFeed"
                }
              }
            }
          }
        }
      }
    },
    "/feeds/availability.json": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getAvailabilityFeed",
        "summary": "Get public availability, language, deployment, and agent readiness data",
        "responses": {
          "200": {
            "description": "Comturk availability feed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AvailabilityFeed"
                }
              }
            }
          }
        }
      }
    },
    "/feeds/inventory.json": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getInventoryFeed",
        "summary": "Get SaaS service inventory for plans, products, integrations, and deployment options",
        "responses": {
          "200": {
            "description": "Comturk service inventory feed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InventoryFeed"
                }
              }
            }
          }
        }
      }
    },
    "/feeds/catalog.xml": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getCatalogXmlFeed",
        "summary": "Get XML catalog feed for systems that prefer XML",
        "responses": {
          "200": {
            "description": "Comturk XML catalog feed",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PricingFeed": {
        "type": "object",
        "required": [
          "schema_version",
          "name",
          "currency",
          "billing_period",
          "plans"
        ],
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "source_page": {
            "type": "string",
            "format": "uri"
          },
          "last_updated": {
            "type": "string",
            "format": "date"
          },
          "currency": {
            "type": "string"
          },
          "billing_period": {
            "type": "string"
          },
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Plan"
            }
          }
        }
      },
      "Plan": {
        "type": "object",
        "required": [
          "id",
          "name",
          "price",
          "currency",
          "billing_period",
          "availability",
          "included"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "billing_period": {
            "type": "string"
          },
          "availability": {
            "type": "string",
            "enum": [
              "available",
              "planned",
              "not_available"
            ]
          },
          "popular": {
            "type": "boolean"
          },
          "included": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "signup_url": {
            "type": "string",
            "format": "uri"
          },
          "contact_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "ProductFeed": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogItem"
            }
          },
          "primary_actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Action"
            }
          }
        }
      },
      "IntegrationsFeed": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "channels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogItem"
            }
          },
          "integrations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogItem"
            }
          }
        }
      },
      "AvailabilityFeed": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "service_regions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Language"
            }
          },
          "deployment_options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogItem"
            }
          },
          "sales_actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Action"
            }
          },
          "booking": {
            "type": "object"
          },
          "agent_commerce": {
            "type": "object"
          }
        }
      },
      "InventoryFeed": {
        "type": "object",
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "inventory_model": {
            "type": "string"
          },
          "reservation_supported": {
            "type": "boolean"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InventoryItem"
            }
          }
        }
      },
      "InventoryItem": {
        "type": "object",
        "required": [
          "id",
          "type",
          "name",
          "status",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "plan",
              "product",
              "integration",
              "deployment"
            ]
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "available",
              "planned",
              "not_available"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "CatalogItem": {
        "type": "object",
        "required": [
          "id",
          "name",
          "status",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "available",
              "planned",
              "not_available"
            ]
          },
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "Action": {
        "type": "object",
        "required": [
          "id",
          "name",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "Language": {
        "type": "object",
        "required": [
          "code",
          "name",
          "url"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    }
  },
  "x-agent-commerce": {
    "status": "planned",
    "current_public_actions": [
      "read_pricing",
      "read_product_catalog",
      "read_integration_availability",
      "read_service_inventory",
      "start_signup",
      "contact_sales"
    ],
    "transactional_checkout_endpoint": "not_available",
    "booking_endpoint": "not_available",
    "authenticated_account_api": "not_available"
  }
}