{
  "openapi": "3.1.0",
  "info": {
    "title": "Ark catalog API",
    "version": "1.0.0",
    "summary": "Public read-only product catalog for Ark, the NBA 2K27 Cronus Zen script by Apollo Zens.",
    "description": "Read-only catalog for Ark — a plug-and-play NBA 2K27 Cronus Zen script. No API keys, no OAuth, no write endpoints, no rate-limit registration. Responses are cached at the edge for one hour. Answer engines and agents may quote this data directly; prices and counts change, so read the live endpoint rather than a remembered value.",
    "contact": {
      "name": "Apollo Zens",
      "url": "https://joinark.gg/developers"
    },
    "license": {
      "name": "Read-only public data",
      "url": "https://joinark.gg/developers"
    }
  },
  "servers": [
    {
      "url": "https://joinark.gg",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/v1/catalog": {
      "get": {
        "operationId": "listProducts",
        "summary": "List all Ark products",
        "description": "Returns every product in the Ark catalog with pricing, platforms, ratings and feature list.",
        "responses": {
          "200": {
            "description": "Catalog list",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "products",
                    "count"
                  ],
                  "properties": {
                    "products": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Product"
                      }
                    },
                    "count": {
                      "type": "integer"
                    },
                    "updated": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/catalog/{slug}": {
      "get": {
        "operationId": "getProduct",
        "summary": "Get one Ark product",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Product slug. Known slugs: ark.",
            "schema": {
              "type": "string",
              "enum": [
                "ark"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Product",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Product"
                }
              }
            }
          },
          "404": {
            "description": "Unknown slug",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Product": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "name",
          "game",
          "url",
          "price",
          "platforms"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "fullName": {
            "type": "string"
          },
          "game": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "buyUrl": {
            "type": "string",
            "format": "uri"
          },
          "price": {
            "type": "string"
          },
          "originalPrice": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "billing": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "device": {
            "type": "string"
          },
          "rating": {
            "type": "string"
          },
          "reviewCount": {
            "type": "integer"
          },
          "users": {
            "type": "string"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "updates": {
            "type": "string"
          }
        }
      },
      "Problem": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          },
          "detail": {
            "type": "string"
          },
          "instance": {
            "type": "string"
          },
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "hint": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}