{
  "openapi": "3.1.0",
  "info": {
    "title": "ITexSpot API",
    "version": "1.0.0-beta",
    "summary": "Výhled spotové ceny elektřiny v Česku na 7 dní pro chytrou domácnost.",
    "description": "Vyhlášené ceny denního trhu na dnešek a zítřek a za nimi naše předpověď na zbytek týdne po hodinách, s pásmem nejistoty p10–p90. Ceny v Kč/kWh, časy ISO 8601 s posunem Europe/Prague, názvy polí česky bez diakritiky.\n\n**Limity:** 60 dotazů za hodinu a 500 za den na klíč (úroveň Zdarma 100 za den); navíc 30 dotazů za minutu z jedné IP adresy napříč klíči (i pro stav.json) a nejvýš 10 neplatných pokusů o klíč za 10 minut z jedné adresy. Překročení vrátí 429 s hlavičkou `Retry-After`. Data se mění několikrát denně — doporučený interval: Loxone 300 s, Home Assistant 15 min, evcc 1 h.\n\n**Verzování:** přidání pole není změna verze; odebrání pole nebo změna významu znamená `/v2` a `/v1` poběží dál nejméně 12 měsíců.\n\nBeta provoz zdarma. Předpověď je orientační údaj, ne záruka.",
    "termsOfService": "https://www.itexservices.cz/itexspot/podminky-api",
    "contact": {
      "name": "ITex Services s.r.o.",
      "email": "info@itexservices.cz",
      "url": "https://www.itexservices.cz/itexspot/api"
    }
  },
  "externalDocs": {
    "description": "Dokumentace a návody (Loxone, Home Assistant, evcc, Node-RED)",
    "url": "https://www.itexservices.cz/itexspot/api"
  },
  "servers": [
    {
      "url": "https://www.itexservices.cz/api/spot/v1",
      "description": "Produkce"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    },
    {
      "basicAuth": []
    }
  ],
  "tags": [
    {
      "name": "Ceny",
      "description": "Výhled, cena teď a okna."
    },
    {
      "name": "Řízení",
      "description": "Rozvrh spotřeby a omezení přetoků."
    },
    {
      "name": "Integrace",
      "description": "Formáty pro Loxone a evcc."
    },
    {
      "name": "Stav",
      "description": "Stav dat bez klíče."
    }
  ],
  "paths": {
    "/vyhled.json": {
      "get": {
        "tags": [
          "Ceny"
        ],
        "summary": "Výhled ceny na 7 dní",
        "description": "Hodinová řada: vyhlášené ceny denního trhu, za nimi naše předpověď s pásmem p10–p90.",
        "operationId": "vyhled",
        "parameters": [
          {
            "$ref": "#/components/parameters/krok"
          },
          {
            "$ref": "#/components/parameters/hodinVyhled"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Řada slotů.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Vyhled"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "krok": 60,
                  "rozliseni_predpovedi": 60,
                  "sloty": [
                    {
                      "od": "2026-11-21T12:00:00+01:00",
                      "do": "2026-11-21T13:00:00+01:00",
                      "zdroj": "predpoved",
                      "spot": 1.95,
                      "p10": 1.1,
                      "p50": 1.95,
                      "p90": 2.9,
                      "uroven": "levna",
                      "poradi_dne": 1,
                      "p_zaporna": 0.1
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/vyhled.json": {
      "get": {
        "tags": [
          "Ceny"
        ],
        "summary": "Výhled ceny na 7 dní",
        "description": "Hodinová řada: vyhlášené ceny denního trhu, za nimi naše předpověď s pásmem p10–p90.",
        "operationId": "vyhledKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/krok"
          },
          {
            "$ref": "#/components/parameters/hodinVyhled"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Řada slotů.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Vyhled"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "krok": 60,
                  "rozliseni_predpovedi": 60,
                  "sloty": [
                    {
                      "od": "2026-11-21T12:00:00+01:00",
                      "do": "2026-11-21T13:00:00+01:00",
                      "zdroj": "predpoved",
                      "spot": 1.95,
                      "p10": 1.1,
                      "p50": 1.95,
                      "p90": 2.9,
                      "uroven": "levna",
                      "poradi_dne": 1,
                      "p_zaporna": 0.1
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/ted.json": {
      "get": {
        "tags": [
          "Ceny"
        ],
        "summary": "Cena teď a nejbližší okna",
        "description": "Cena a úroveň běžící hodiny, nejlevnější a nejdražší 3h okno, riziko záporné ceny a „počkat“.",
        "operationId": "ted",
        "parameters": [
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Stav teď.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Ted"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "ted": {
                    "od": "2026-11-18T15:00:00+01:00",
                    "do": "2026-11-18T16:00:00+01:00",
                    "zdroj": "trh",
                    "spot": 2.31,
                    "koncova": 4.012,
                    "uroven": "levna",
                    "poradi_dne": 6,
                    "p_zaporna": 0
                  },
                  "cena_ted": 4.012,
                  "spot_ted": 2.31,
                  "uroven_ted": "levna",
                  "levno_ted": true,
                  "zmena_urovne_v": "2026-11-18T16:00:00+01:00",
                  "okno_3h": {
                    "od": "2026-11-19T12:00:00+01:00",
                    "do": "2026-11-19T15:00:00+01:00",
                    "cena": 1.84,
                    "cena_p10": 1.84,
                    "cena_p90": 1.84,
                    "jistota": "vysoka",
                    "koncova": 3.41,
                    "za_min": 1245
                  },
                  "nejdrazsi_3h": {
                    "od": "2026-11-18T17:00:00+01:00",
                    "do": "2026-11-18T20:00:00+01:00",
                    "cena": 4.6,
                    "cena_p10": 4.6,
                    "cena_p90": 4.6,
                    "jistota": "vysoka",
                    "koncova": 6.9,
                    "za_min": 105
                  },
                  "p_zaporna_dnes": 0,
                  "pockat": {
                    "beta": true,
                    "delka": 3,
                    "rozdil": 0.3,
                    "nejlepsi_znama": {
                      "od": "2026-11-19T12:00:00+01:00",
                      "do": "2026-11-19T15:00:00+01:00",
                      "cena": 1.84
                    },
                    "levneji_pozdeji": "stredni"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/ted.json": {
      "get": {
        "tags": [
          "Ceny"
        ],
        "summary": "Cena teď a nejbližší okna",
        "description": "Cena a úroveň běžící hodiny, nejlevnější a nejdražší 3h okno, riziko záporné ceny a „počkat“.",
        "operationId": "tedKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Stav teď.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Ted"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "ted": {
                    "od": "2026-11-18T15:00:00+01:00",
                    "do": "2026-11-18T16:00:00+01:00",
                    "zdroj": "trh",
                    "spot": 2.31,
                    "koncova": 4.012,
                    "uroven": "levna",
                    "poradi_dne": 6,
                    "p_zaporna": 0
                  },
                  "cena_ted": 4.012,
                  "spot_ted": 2.31,
                  "uroven_ted": "levna",
                  "levno_ted": true,
                  "zmena_urovne_v": "2026-11-18T16:00:00+01:00",
                  "okno_3h": {
                    "od": "2026-11-19T12:00:00+01:00",
                    "do": "2026-11-19T15:00:00+01:00",
                    "cena": 1.84,
                    "cena_p10": 1.84,
                    "cena_p90": 1.84,
                    "jistota": "vysoka",
                    "koncova": 3.41,
                    "za_min": 1245
                  },
                  "nejdrazsi_3h": {
                    "od": "2026-11-18T17:00:00+01:00",
                    "do": "2026-11-18T20:00:00+01:00",
                    "cena": 4.6,
                    "cena_p10": 4.6,
                    "cena_p90": 4.6,
                    "jistota": "vysoka",
                    "koncova": 6.9,
                    "za_min": 105
                  },
                  "p_zaporna_dnes": 0,
                  "pockat": {
                    "beta": true,
                    "delka": 3,
                    "rozdil": 0.3,
                    "nejlepsi_znama": {
                      "od": "2026-11-19T12:00:00+01:00",
                      "do": "2026-11-19T15:00:00+01:00",
                      "cena": 1.84
                    },
                    "levneji_pozdeji": "stredni"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/okna.json": {
      "get": {
        "tags": [
          "Ceny"
        ],
        "summary": "Nejlevnější a nejdražší okna",
        "description": "Nepřekrývající se souvislá okna dané délky od běžící hodiny.",
        "operationId": "okna",
        "parameters": [
          {
            "$ref": "#/components/parameters/delka"
          },
          {
            "$ref": "#/components/parameters/pocet"
          },
          {
            "$ref": "#/components/parameters/doOkna"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Okna.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Okna"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "delka": 3,
                  "do": null,
                  "nejlevnejsi": [
                    {
                      "od": "2026-11-19T12:00:00+01:00",
                      "do": "2026-11-19T15:00:00+01:00",
                      "cena": 1.84,
                      "cena_p10": 1.84,
                      "cena_p90": 1.84,
                      "jistota": "vysoka",
                      "koncova": 3.41,
                      "za_min": 1245
                    }
                  ],
                  "nejdrazsi": [
                    {
                      "od": "2026-11-18T17:00:00+01:00",
                      "do": "2026-11-18T20:00:00+01:00",
                      "cena": 4.6,
                      "cena_p10": 4.6,
                      "cena_p90": 4.6,
                      "jistota": "vysoka",
                      "koncova": 6.9,
                      "za_min": 105
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/okna.json": {
      "get": {
        "tags": [
          "Ceny"
        ],
        "summary": "Nejlevnější a nejdražší okna",
        "description": "Nepřekrývající se souvislá okna dané délky od běžící hodiny.",
        "operationId": "oknaKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/delka"
          },
          {
            "$ref": "#/components/parameters/pocet"
          },
          {
            "$ref": "#/components/parameters/doOkna"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Okna.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Okna"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "delka": 3,
                  "do": null,
                  "nejlevnejsi": [
                    {
                      "od": "2026-11-19T12:00:00+01:00",
                      "do": "2026-11-19T15:00:00+01:00",
                      "cena": 1.84,
                      "cena_p10": 1.84,
                      "cena_p90": 1.84,
                      "jistota": "vysoka",
                      "koncova": 3.41,
                      "za_min": 1245
                    }
                  ],
                  "nejdrazsi": [
                    {
                      "od": "2026-11-18T17:00:00+01:00",
                      "do": "2026-11-18T20:00:00+01:00",
                      "cena": 4.6,
                      "cena_p10": 4.6,
                      "cena_p90": 4.6,
                      "jistota": "vysoka",
                      "koncova": 6.9,
                      "za_min": 105
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/loxone.txt": {
      "get": {
        "tags": [
          "Integrace"
        ],
        "summary": "Výstup pro Loxone",
        "description": "Totéž co ted.json jako řádky `nazev=hodnota` + ceny na 48 h (h00 = běžící hodina). Desetinná tečka, chybějící hodnota = -999, `stav_kod` vždy první. Rozpoznání v Loxone: `\\icena_ted=\\i\\v`.",
        "operationId": "loxone",
        "parameters": [
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Text pro Virtual HTTP Input.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "stav_kod=0\nstav=ok\ncena_ted=4.012\nspot_ted=2.31\nlevno_ted=1\nuroven_ted=1\nokno3_za_min=185\nokno3_cena=3.41\ndrahe3_za_min=125\ndrahe3_cena=6.9\npockat_uroven=1\nzaporna_dnes_p=0\nstari_min=42\nh00=4.012\nh01=4.105\n…\nh47=3.88\n"
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/loxone.txt": {
      "get": {
        "tags": [
          "Integrace"
        ],
        "summary": "Výstup pro Loxone",
        "description": "Totéž co ted.json jako řádky `nazev=hodnota` + ceny na 48 h (h00 = běžící hodina). Desetinná tečka, chybějící hodnota = -999, `stav_kod` vždy první. Rozpoznání v Loxone: `\\icena_ted=\\i\\v`.",
        "operationId": "loxoneKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Text pro Virtual HTTP Input.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "stav_kod=0\nstav=ok\ncena_ted=4.012\nspot_ted=2.31\nlevno_ted=1\nuroven_ted=1\nokno3_za_min=185\nokno3_cena=3.41\ndrahe3_za_min=125\ndrahe3_cena=6.9\npockat_uroven=1\nzaporna_dnes_p=0\nstari_min=42\nh00=4.012\nh01=4.105\n…\nh47=3.88\n"
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/evcc.json": {
      "get": {
        "tags": [
          "Integrace"
        ],
        "summary": "Vlastní tarif pro evcc",
        "description": "Pole `{start, end, value}` od běžící hodiny, časy v UTC se `Z`. `value` je koncová cena, má-li klíč tarif, jinak spot.",
        "operationId": "evcc",
        "parameters": [
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Ceny pro evcc.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvccSlot"
                  }
                },
                "example": [
                  {
                    "start": "2026-11-18T14:00:00Z",
                    "end": "2026-11-18T15:00:00Z",
                    "value": 4.012
                  }
                ]
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/evcc.json": {
      "get": {
        "tags": [
          "Integrace"
        ],
        "summary": "Vlastní tarif pro evcc",
        "description": "Pole `{start, end, value}` od běžící hodiny, časy v UTC se `Z`. `value` je koncová cena, má-li klíč tarif, jinak spot.",
        "operationId": "evccKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Ceny pro evcc.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvccSlot"
                  }
                },
                "example": [
                  {
                    "start": "2026-11-18T14:00:00Z",
                    "end": "2026-11-18T15:00:00Z",
                    "value": 4.012
                  }
                ]
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/schedule.json": {
      "get": {
        "tags": [
          "Řízení"
        ],
        "summary": "Rozvrh spotřeby",
        "description": "N nejlevnějších hodin v každém dni, nebo cílové nabíjení (`kwh` + `kw`, volitelně `do` a `ucinnost`). `pod` přidá každou hodinu pod hranicí.",
        "operationId": "schedule",
        "parameters": [
          {
            "$ref": "#/components/parameters/hodinRozvrh"
          },
          {
            "$ref": "#/components/parameters/pod"
          },
          {
            "$ref": "#/components/parameters/kwh"
          },
          {
            "$ref": "#/components/parameters/kw"
          },
          {
            "$ref": "#/components/parameters/doNabijeni"
          },
          {
            "$ref": "#/components/parameters/ucinnost"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Rozvrh.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rozvrh"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "rezim": "hodiny_denne",
                  "hodin_vybrano": 2,
                  "aktivni_ted": false,
                  "aktivni_do": null,
                  "dalsi_od": "2026-11-19T12:00:00+01:00",
                  "intervaly": [
                    {
                      "od": "2026-11-19T12:00:00+01:00",
                      "do": "2026-11-19T14:00:00+01:00"
                    }
                  ],
                  "unix": [
                    [
                      1795086000,
                      1795093200
                    ]
                  ],
                  "hodiny": [
                    {
                      "od": "2026-11-19T12:00:00+01:00",
                      "cena": 3.3,
                      "zdroj": "trh"
                    },
                    {
                      "od": "2026-11-19T13:00:00+01:00",
                      "cena": 3.4,
                      "zdroj": "trh"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/schedule.json": {
      "get": {
        "tags": [
          "Řízení"
        ],
        "summary": "Rozvrh spotřeby",
        "description": "N nejlevnějších hodin v každém dni, nebo cílové nabíjení (`kwh` + `kw`, volitelně `do` a `ucinnost`). `pod` přidá každou hodinu pod hranicí.",
        "operationId": "scheduleKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/hodinRozvrh"
          },
          {
            "$ref": "#/components/parameters/pod"
          },
          {
            "$ref": "#/components/parameters/kwh"
          },
          {
            "$ref": "#/components/parameters/kw"
          },
          {
            "$ref": "#/components/parameters/doNabijeni"
          },
          {
            "$ref": "#/components/parameters/ucinnost"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Rozvrh.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rozvrh"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "rezim": "hodiny_denne",
                  "hodin_vybrano": 2,
                  "aktivni_ted": false,
                  "aktivni_do": null,
                  "dalsi_od": "2026-11-19T12:00:00+01:00",
                  "intervaly": [
                    {
                      "od": "2026-11-19T12:00:00+01:00",
                      "do": "2026-11-19T14:00:00+01:00"
                    }
                  ],
                  "unix": [
                    [
                      1795086000,
                      1795093200
                    ]
                  ],
                  "hodiny": [
                    {
                      "od": "2026-11-19T12:00:00+01:00",
                      "cena": 3.3,
                      "zdroj": "trh"
                    },
                    {
                      "od": "2026-11-19T13:00:00+01:00",
                      "cena": 3.4,
                      "zdroj": "trh"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/export.json": {
      "get": {
        "tags": [
          "Řízení"
        ],
        "summary": "Kdy omezit přetoky",
        "description": "Hodiny, kdy výkupní cena (spot − poplatek) klesne pod práh.",
        "operationId": "export",
        "parameters": [
          {
            "$ref": "#/components/parameters/poplatek"
          },
          {
            "$ref": "#/components/parameters/prah"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Omezení přetoků.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Export"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "poplatek": 0.5,
                  "prah": 0,
                  "aktivni_ted": false,
                  "aktivni_do": null,
                  "dalsi_od": "2026-11-22T12:00:00+01:00",
                  "intervaly": [
                    {
                      "od": "2026-11-22T12:00:00+01:00",
                      "do": "2026-11-22T13:00:00+01:00"
                    }
                  ],
                  "unix": [
                    [
                      1795345200,
                      1795348800
                    ]
                  ],
                  "hodiny": [
                    {
                      "od": "2026-11-22T12:00:00+01:00",
                      "vykup": -0.12,
                      "zdroj": "predpoved",
                      "p_vykup_pod_prahem": 0.6
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/k/{klic}/export.json": {
      "get": {
        "tags": [
          "Řízení"
        ],
        "summary": "Kdy omezit přetoky",
        "description": "Hodiny, kdy výkupní cena (spot − poplatek) klesne pod práh.",
        "operationId": "exportKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          },
          {
            "$ref": "#/components/parameters/poplatek"
          },
          {
            "$ref": "#/components/parameters/prah"
          },
          {
            "$ref": "#/components/parameters/strategie"
          },
          {
            "$ref": "#/components/parameters/strategy"
          }
        ],
        "responses": {
          "200": {
            "description": "Omezení přetoků.",
            "headers": {
              "Cache-Control": {
                "description": "`public` u klíče v cestě (adresa je unikátní pro klíč), `private` u klíče v hlavičce. Platnost do `dalsi_aktualizace`, nejvýš 30 min.",
                "schema": {
                  "type": "string"
                }
              },
              "X-ITexSpot-Dalsi-Aktualizace": {
                "description": "Totéž co `dalsi_aktualizace` v těle.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Export"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "mena": "CZK",
                  "jednotka": "Kc/kWh",
                  "kurz_eur": 24.38,
                  "uroven_klice": "beta",
                  "strategie": "p50",
                  "tarif": {
                    "pouzit": true,
                    "dph": true
                  },
                  "poplatek": 0.5,
                  "prah": 0,
                  "aktivni_ted": false,
                  "aktivni_do": null,
                  "dalsi_od": "2026-11-22T12:00:00+01:00",
                  "intervaly": [
                    {
                      "od": "2026-11-22T12:00:00+01:00",
                      "do": "2026-11-22T13:00:00+01:00"
                    }
                  ],
                  "unix": [
                    [
                      1795345200,
                      1795348800
                    ]
                  ],
                  "hodiny": [
                    {
                      "od": "2026-11-22T12:00:00+01:00",
                      "vykup": -0.12,
                      "zdroj": "predpoved",
                      "p_vykup_pod_prahem": 0.6
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Neplatny401"
          },
          "422": {
            "$ref": "#/components/responses/Parametr422"
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "$ref": "#/components/responses/Nedostupne503"
          }
        }
      }
    },
    "/stav.json": {
      "get": {
        "tags": [
          "Stav"
        ],
        "summary": "Stav dat (bez klíče)",
        "description": "Čas posledního vydání a stáří dat. Bez klíče, ale limit podle IP platí.",
        "operationId": "stav",
        "security": [],
        "responses": {
          "200": {
            "description": "Stav.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Stav"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "znama_do": "2026-11-20T00:00:00+01:00",
                  "predpoved_do": "2026-11-26T00:00:00+01:00"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "description": "Data nejsou k dispozici.",
            "headers": {
              "Retry-After": {
                "description": "Za kolik sekund to zkusit znovu.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verze": {
                      "type": "string",
                      "const": "1"
                    },
                    "stav": {
                      "type": "string",
                      "const": "nedostupne"
                    }
                  }
                },
                "example": {
                  "verze": "1",
                  "stav": "nedostupne"
                }
              }
            }
          }
        }
      }
    },
    "/k/{klic}/stav.json": {
      "get": {
        "tags": [
          "Stav"
        ],
        "summary": "Stav dat (bez klíče)",
        "description": "Totéž co /stav.json; klíč v cestě se nečte (pro jednotnou adresu v konfiguraci).",
        "operationId": "stavKlicVCeste",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/klic"
          }
        ],
        "responses": {
          "200": {
            "description": "Stav.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Stav"
                },
                "example": {
                  "verze": "1",
                  "beta": true,
                  "stav": "ok",
                  "vydano": "2026-11-18T14:15:00+01:00",
                  "vytvoreno": "2026-11-18T14:21:10+01:00",
                  "dalsi_aktualizace": "2026-11-19T06:30:00+01:00",
                  "stari_min": 42,
                  "znama_do": "2026-11-20T00:00:00+01:00",
                  "predpoved_do": "2026-11-26T00:00:00+01:00"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/Limit429"
          },
          "503": {
            "description": "Data nejsou k dispozici.",
            "headers": {
              "Retry-After": {
                "description": "Za kolik sekund to zkusit znovu.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verze": {
                      "type": "string",
                      "const": "1"
                    },
                    "stav": {
                      "type": "string",
                      "const": "nedostupne"
                    }
                  }
                },
                "example": {
                  "verze": "1",
                  "stav": "nedostupne"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "`Authorization: Bearer its_…` — doporučeno pro Home Assistant, Node-RED, evcc a vlastní kód."
      },
      "basicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Klíč jako uživatel NEBO heslo (druhé pole libovolné). Pro Loxone: `https://its_…@www.itexservices.cz/…`."
      }
    },
    "parameters": {
      "klic": {
        "name": "klic",
        "in": "path",
        "required": true,
        "description": "API klíč přímo v cestě (pro Loxone a jednoduché skripty). Odpověď smí cachovat i CDN.",
        "schema": {
          "type": "string",
          "pattern": "^its_[0-9a-f]{40}$"
        }
      },
      "strategie": {
        "name": "strategie",
        "in": "query",
        "description": "Hodnota předpovědi: p10, p50 (výchozí), p90. Přijímá i aliasy aggressive = p10, balanced = p50, conservative = p90.",
        "schema": {
          "type": "string",
          "enum": [
            "p10",
            "p50",
            "p90",
            "aggressive",
            "balanced",
            "conservative"
          ],
          "default": "p50"
        }
      },
      "strategy": {
        "name": "strategy",
        "in": "query",
        "description": "Anglický alias parametru `strategie`.",
        "schema": {
          "type": "string",
          "enum": [
            "p10",
            "p50",
            "p90",
            "aggressive",
            "balanced",
            "conservative"
          ]
        }
      },
      "krok": {
        "name": "krok",
        "in": "query",
        "description": "Délka slotu v minutách. Čtvrthodiny jen u vyhlášených cen; předpověď se opakuje.",
        "schema": {
          "type": "integer",
          "enum": [
            15,
            60
          ],
          "default": 60
        }
      },
      "hodinVyhled": {
        "name": "hodin",
        "in": "query",
        "description": "Kolik hodin řady vrátit.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 200
        }
      },
      "delka": {
        "name": "delka",
        "in": "query",
        "description": "Délka okna v hodinách.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 12,
          "default": 3
        }
      },
      "pocet": {
        "name": "pocet",
        "in": "query",
        "description": "Kolik oken vrátit.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 5,
          "default": 3
        }
      },
      "doOkna": {
        "name": "do",
        "in": "query",
        "description": "Hledat jen okna končící do tohoto času. ISO 8601; bez posunu = místní čas v Praze. V budoucnosti, nejvýš 9 dní dopředu.",
        "schema": {
          "type": "string",
          "example": "2026-11-20T06:00"
        }
      },
      "hodinRozvrh": {
        "name": "hodin",
        "in": "query",
        "description": "Kolik nejlevnějších hodin v každém dni vybrat (výchozí 4, se zadaným `pod` 0).",
        "schema": {
          "type": "integer",
          "minimum": 0,
          "maximum": 24,
          "default": 4
        }
      },
      "pod": {
        "name": "pod",
        "in": "query",
        "description": "Přidat každou hodinu s cenou pod touto hranicí (Kč/kWh, cena pro uživatele).",
        "schema": {
          "type": "number",
          "minimum": -10,
          "maximum": 50
        }
      },
      "kwh": {
        "name": "kwh",
        "in": "query",
        "description": "Cílové nabíjení: kolik kWh dodat. Vyžaduje `kw`.",
        "schema": {
          "type": "number",
          "minimum": 0.1,
          "maximum": 500
        }
      },
      "kw": {
        "name": "kw",
        "in": "query",
        "description": "Výkon nabíjení v kW (k parametru `kwh`).",
        "schema": {
          "type": "number",
          "minimum": 0.1,
          "maximum": 100
        }
      },
      "doNabijeni": {
        "name": "do",
        "in": "query",
        "description": "Termín cílového nabíjení. ISO 8601; bez posunu = místní čas v Praze.",
        "schema": {
          "type": "string",
          "example": "2026-11-20T06:00"
        }
      },
      "ucinnost": {
        "name": "ucinnost",
        "in": "query",
        "description": "Účinnost nabíjení.",
        "schema": {
          "type": "number",
          "minimum": 0.5,
          "maximum": 1,
          "default": 0.9
        }
      },
      "poplatek": {
        "name": "poplatek",
        "in": "query",
        "description": "Poplatek výkupce v Kč/kWh. Výchozí z tarifu klíče, jinak 0.",
        "schema": {
          "type": "number",
          "minimum": 0,
          "maximum": 10
        }
      },
      "prah": {
        "name": "prah",
        "in": "query",
        "description": "Omezit přetoky, když výkupní cena klesne pod tuto hodnotu (Kč/kWh).",
        "schema": {
          "type": "number",
          "minimum": -10,
          "maximum": 10,
          "default": 0
        }
      }
    },
    "responses": {
      "Neplatny401": {
        "description": "Chybí klíč, má špatný tvar, nebo je neplatný či zrušený.",
        "headers": {
          "WWW-Authenticate": {
            "description": "Výzva k Basic Auth (`Basic realm=\"ITexSpot API\"`).",
            "schema": {
              "type": "string"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Chyba"
            },
            "example": {
              "verze": "1",
              "stav": "neplatny_klic",
              "chyba": "Neplatný nebo zrušený API klíč."
            }
          },
          "text/plain": {
            "schema": {
              "type": "string"
            },
            "description": "Jen u loxone.txt.",
            "example": "stav_kod=401\nstav=neplatny_klic\nzprava=Neplatný nebo zrušený API klíč.\n"
          }
        }
      },
      "Parametr422": {
        "description": "Neznámý parametr nebo hodnota mimo rozsah.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Chyba"
            },
            "example": {
              "verze": "1",
              "stav": "neplatny_parametr",
              "chyba": "Parametr delka musí být celé číslo v rozsahu 1–12."
            }
          },
          "text/plain": {
            "schema": {
              "type": "string"
            },
            "description": "Jen u loxone.txt.",
            "example": "stav_kod=422\nstav=neplatny_parametr\nzprava=Neznámý parametr x.\n"
          }
        }
      },
      "Limit429": {
        "description": "Překročený limit: na klíč (hodina, den), podle IP adresy, nebo příliš mnoho neplatných pokusů o klíč z jedné adresy.",
        "headers": {
          "Retry-After": {
            "description": "Za kolik sekund to zkusit znovu.",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Chyba"
            },
            "example": {
              "verze": "1",
              "stav": "limit",
              "chyba": "Překročen hodinový limit dotazů pro klíč."
            }
          },
          "text/plain": {
            "schema": {
              "type": "string"
            },
            "description": "Jen u loxone.txt.",
            "example": "stav_kod=429\nstav=limit\nzprava=Překročen hodinový limit dotazů pro klíč.\n"
          }
        }
      },
      "Nedostupne503": {
        "description": "Dočasný výpadek (data nebo databáze).",
        "headers": {
          "Retry-After": {
            "description": "Za kolik sekund to zkusit znovu.",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Chyba"
            },
            "example": {
              "verze": "1",
              "stav": "nedostupne",
              "chyba": "Data jsou dočasně nedostupná."
            }
          },
          "text/plain": {
            "schema": {
              "type": "string"
            },
            "description": "Jen u loxone.txt.",
            "example": "stav_kod=503\nstav=nedostupne\nzprava=Data jsou dočasně nedostupná.\n"
          }
        }
      }
    },
    "schemas": {
      "Hlavicka": {
        "type": "object",
        "description": "Společná hlavička všech JSON odpovědí s klíčem (kromě evcc.json).",
        "required": [
          "verze",
          "beta",
          "stav",
          "vydano",
          "vytvoreno",
          "dalsi_aktualizace",
          "stari_min",
          "mena",
          "jednotka",
          "kurz_eur",
          "uroven_klice",
          "strategie",
          "tarif"
        ],
        "properties": {
          "verze": {
            "type": "string",
            "const": "1",
            "description": "Hlavní verze API."
          },
          "beta": {
            "type": "boolean",
            "const": true,
            "description": "API je v beta provozu."
          },
          "stav": {
            "type": "string",
            "enum": [
              "ok",
              "stara_data"
            ],
            "description": "`stara_data`, když jsou data starší než 30 hodin."
          },
          "vydano": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Kdy jsme výhled vydali (ISO 8601 s posunem Europe/Prague)."
          },
          "vytvoreno": {
            "type": "string",
            "format": "date-time",
            "description": "Kdy vznikl dokument, ze kterého odpověď počítáme."
          },
          "dalsi_aktualizace": {
            "type": "string",
            "format": "date-time",
            "description": "Nejbližší plánovaná obnova dat. Dřívější dotaz nic nového nepřinese."
          },
          "stari_min": {
            "type": "integer",
            "minimum": 0,
            "description": "Stáří dat v minutách."
          },
          "mena": {
            "type": "string",
            "const": "CZK"
          },
          "jednotka": {
            "type": "string",
            "const": "Kc/kWh"
          },
          "kurz_eur": {
            "type": "number",
            "description": "Kurz EUR/CZK (ČNB), kterým jsme přepočetli ceny trhu."
          },
          "uroven_klice": {
            "type": "string",
            "enum": [
              "beta",
              "zdarma",
              "placeny"
            ],
            "description": "Úroveň klíče. `zdarma` dostane předpověď jen 48 h za poslední vyhlášenou hodinou a bez pásma."
          },
          "strategie": {
            "$ref": "#/components/schemas/Strategie"
          },
          "tarif": {
            "type": "object",
            "required": [
              "pouzit",
              "dph"
            ],
            "properties": {
              "pouzit": {
                "type": "boolean",
                "description": "Má klíč uložený tarif (odpovědi pak nesou koncovou cenu)."
              },
              "dph": {
                "type": "boolean",
                "description": "Koncová cena je včetně DPH."
              }
            }
          }
        }
      },
      "Strategie": {
        "type": "string",
        "enum": [
          "p10",
          "p50",
          "p90"
        ],
        "description": "Která hodnota předpovědi se bere jako „cena“: p10 (optimisticky nízko), p50 (střed), p90 (opatrně vysoko)."
      },
      "Uroven": {
        "type": [
          "string",
          "null"
        ],
        "enum": [
          "zaporna",
          "levna",
          "bezna",
          "draha",
          null
        ],
        "description": "`levna` = nejlevnější třetina hodin dne, `draha` = nejdražší třetina, `zaporna` = cena pod nulou."
      },
      "Slot": {
        "type": "object",
        "description": "Jedna hodina (nebo čtvrthodina u `krok=15`).",
        "required": [
          "od",
          "do",
          "zdroj",
          "spot",
          "uroven",
          "poradi_dne",
          "p_zaporna"
        ],
        "properties": {
          "od": {
            "type": "string",
            "format": "date-time",
            "description": "Začátek."
          },
          "do": {
            "type": "string",
            "format": "date-time",
            "description": "Konec."
          },
          "zdroj": {
            "type": "string",
            "enum": [
              "trh",
              "predpoved"
            ],
            "description": "`trh` = vyhlášená cena denního trhu, `predpoved` = náš odhad."
          },
          "spot": {
            "type": "number",
            "description": "Spotová cena bez DPH a distribuce (Kč/kWh); u předpovědi podle strategie."
          },
          "p10": {
            "type": "number",
            "description": "Dolní okraj pásma předpovědi. Jen u předpovědi a ne u úrovně Zdarma."
          },
          "p50": {
            "type": "number",
            "description": "Střed předpovědi. Jen u předpovědi a ne u úrovně Zdarma."
          },
          "p90": {
            "type": "number",
            "description": "Horní okraj pásma předpovědi. Jen u předpovědi a ne u úrovně Zdarma."
          },
          "koncova": {
            "type": "number",
            "description": "Koncová cena podle tarifu klíče. Jen když má klíč tarif."
          },
          "koncova_p10": {
            "type": "number",
            "description": "Koncová cena z p10. Jen s tarifem a pásmem."
          },
          "koncova_p90": {
            "type": "number",
            "description": "Koncová cena z p90. Jen s tarifem a pásmem."
          },
          "vykup": {
            "type": "number",
            "description": "Výkupní cena = spot − poplatek výkupce. Jen když tarif klíče nese poplatek za výkup."
          },
          "p_vykup_zaporny": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "Pravděpodobnost záporné výkupní ceny. Jen s poplatkem za výkup."
          },
          "uroven": {
            "$ref": "#/components/schemas/Uroven"
          },
          "poradi_dne": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "Pořadí hodiny ve dni podle ceny, 1 = nejlevnější."
          },
          "p_zaporna": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "Pravděpodobnost záporné ceny po desetinách; u vyhlášených hodin 0 nebo 1. 0.1 = nejvýš 10 %, 0.9 = aspoň 90 %."
          }
        }
      },
      "Okno": {
        "type": "object",
        "description": "Souvislé okno hodin; okna se nepřekrývají.",
        "required": [
          "od",
          "do",
          "cena",
          "cena_p10",
          "cena_p90",
          "jistota",
          "za_min"
        ],
        "properties": {
          "od": {
            "type": "string",
            "format": "date-time",
            "description": "Začátek okna."
          },
          "do": {
            "type": "string",
            "format": "date-time",
            "description": "Konec okna."
          },
          "cena": {
            "type": "number",
            "description": "Průměrný spot okna (Kč/kWh)."
          },
          "cena_p10": {
            "type": "number",
            "description": "Průměr p10 hodin okna."
          },
          "cena_p90": {
            "type": "number",
            "description": "Průměr p90 hodin okna."
          },
          "jistota": {
            "type": "string",
            "enum": [
              "vysoka",
              "stredni",
              "nizka"
            ],
            "description": "`vysoka` = všechny hodiny vyhlášené, `stredni` = do 3 dnů, `nizka` = dál."
          },
          "koncova": {
            "type": "number",
            "description": "Průměrná koncová cena. Jen když má klíč tarif."
          },
          "za_min": {
            "type": "integer",
            "minimum": 0,
            "description": "Za kolik minut okno začne (0 = právě běží)."
          }
        }
      },
      "Pockat": {
        "type": "object",
        "description": "„Nabít teď, nebo počkat?“ V betě jen slovně.",
        "required": [
          "beta",
          "delka",
          "rozdil",
          "nejlepsi_znama",
          "levneji_pozdeji"
        ],
        "properties": {
          "beta": {
            "type": "boolean",
            "const": true
          },
          "delka": {
            "type": "integer",
            "description": "Délka okna v hodinách."
          },
          "rozdil": {
            "type": "number",
            "description": "O kolik (Kč/kWh) musí být pozdější okno levnější."
          },
          "nejlepsi_znama": {
            "anyOf": [
              {
                "type": "object",
                "required": [
                  "od",
                  "do",
                  "cena"
                ],
                "properties": {
                  "od": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Začátek."
                  },
                  "do": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Konec."
                  },
                  "cena": {
                    "type": "number",
                    "description": "Průměrný spot."
                  }
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "levneji_pozdeji": {
            "type": "string",
            "enum": [
              "nizka",
              "stredni",
              "vysoka"
            ],
            "description": "Jak pravděpodobné je, že v příštích dnech vyjde okno levnější než nejlepší známé."
          }
        }
      },
      "Intervaly": {
        "type": "object",
        "required": [
          "aktivni_ted",
          "aktivni_do",
          "dalsi_od",
          "intervaly",
          "unix"
        ],
        "properties": {
          "aktivni_ted": {
            "type": "boolean",
            "description": "Běží právě teď vybraný interval."
          },
          "aktivni_do": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Konec běžícího intervalu."
          },
          "dalsi_od": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Začátek dalšího intervalu."
          },
          "intervaly": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "od",
                "do"
              ],
              "properties": {
                "od": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Začátek."
                },
                "do": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Konec."
                }
              }
            }
          },
          "unix": {
            "type": "array",
            "description": "Tytéž intervaly jako dvojice [začátek, konec] v unixových sekundách (Shelly skripty).",
            "items": {
              "type": "array",
              "prefixItems": [
                {
                  "type": "integer"
                },
                {
                  "type": "integer"
                }
              ],
              "minItems": 2,
              "maxItems": 2
            }
          }
        }
      },
      "Vyhled": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Hlavicka"
          },
          {
            "type": "object",
            "required": [
              "krok",
              "rozliseni_predpovedi",
              "sloty"
            ],
            "properties": {
              "krok": {
                "type": "integer",
                "enum": [
                  15,
                  60
                ],
                "description": "Délka slotu v minutách."
              },
              "rozliseni_predpovedi": {
                "type": "integer",
                "const": 60,
                "description": "Předpověď je hodinová; u `krok=15` se hodnota opakuje po čtvrthodinách."
              },
              "sloty": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Slot"
                }
              }
            }
          }
        ]
      },
      "Ted": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Hlavicka"
          },
          {
            "type": "object",
            "required": [
              "ted",
              "cena_ted",
              "spot_ted",
              "uroven_ted",
              "levno_ted",
              "zmena_urovne_v",
              "okno_3h",
              "nejdrazsi_3h",
              "p_zaporna_dnes",
              "pockat"
            ],
            "properties": {
              "ted": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/Slot"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cena_ted": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Cena teď: koncová, má-li klíč tarif, jinak spot."
              },
              "spot_ted": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Spot teď."
              },
              "uroven_ted": {
                "$ref": "#/components/schemas/Uroven"
              },
              "levno_ted": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Levná nebo záporná hodina."
              },
              "zmena_urovne_v": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Kdy se úroveň změní."
              },
              "okno_3h": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/Okno"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "nejdrazsi_3h": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/Okno"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "p_zaporna_dnes": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Nejvyšší pravděpodobnost záporné ceny do konce dne."
              },
              "pockat": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/Pockat"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            }
          }
        ]
      },
      "Okna": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Hlavicka"
          },
          {
            "type": "object",
            "required": [
              "delka",
              "do",
              "nejlevnejsi",
              "nejdrazsi"
            ],
            "properties": {
              "delka": {
                "type": "integer",
                "description": "Délka oken v hodinách."
              },
              "do": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Hledá se jen do tohoto času (parametr `do`)."
              },
              "nejlevnejsi": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Okno"
                }
              },
              "nejdrazsi": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Okno"
                }
              }
            }
          }
        ]
      },
      "Rozvrh": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Hlavicka"
          },
          {
            "$ref": "#/components/schemas/Intervaly"
          },
          {
            "type": "object",
            "required": [
              "rezim",
              "hodin_vybrano",
              "hodiny"
            ],
            "properties": {
              "rezim": {
                "type": "string",
                "enum": [
                  "hodiny_denne",
                  "nabijeni"
                ],
                "description": "`nabijeni` při zadaném `kwh`, jinak N hodin denně."
              },
              "hodin_vybrano": {
                "type": "integer",
                "minimum": 0
              },
              "hodiny": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "od",
                    "cena",
                    "zdroj"
                  ],
                  "properties": {
                    "od": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Začátek hodiny."
                    },
                    "cena": {
                      "type": "number",
                      "description": "Cena pro uživatele (koncová s tarifem, jinak spot)."
                    },
                    "zdroj": {
                      "type": "string",
                      "enum": [
                        "trh",
                        "predpoved"
                      ]
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "Export": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Hlavicka"
          },
          {
            "$ref": "#/components/schemas/Intervaly"
          },
          {
            "type": "object",
            "required": [
              "poplatek",
              "prah",
              "hodiny"
            ],
            "properties": {
              "poplatek": {
                "type": "number",
                "description": "Použitý poplatek výkupce."
              },
              "prah": {
                "type": "number",
                "description": "Použitý práh výkupní ceny."
              },
              "hodiny": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "od",
                    "vykup",
                    "zdroj",
                    "p_vykup_pod_prahem"
                  ],
                  "properties": {
                    "od": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Začátek hodiny."
                    },
                    "vykup": {
                      "type": "number",
                      "description": "Výkupní cena = spot − poplatek."
                    },
                    "zdroj": {
                      "type": "string",
                      "enum": [
                        "trh",
                        "predpoved"
                      ]
                    },
                    "p_vykup_pod_prahem": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Pravděpodobnost, že výkup bude pod prahem."
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "EvccSlot": {
        "type": "object",
        "required": [
          "start",
          "end",
          "value"
        ],
        "properties": {
          "start": {
            "type": "string",
            "format": "date-time",
            "description": "Začátek v UTC se `Z`."
          },
          "end": {
            "type": "string",
            "format": "date-time",
            "description": "Konec v UTC se `Z`."
          },
          "value": {
            "type": "number",
            "description": "Cena pro uživatele (Kč/kWh)."
          }
        }
      },
      "Stav": {
        "type": "object",
        "required": [
          "verze",
          "beta",
          "stav",
          "vydano",
          "vytvoreno",
          "dalsi_aktualizace",
          "stari_min",
          "znama_do",
          "predpoved_do"
        ],
        "properties": {
          "verze": {
            "type": "string",
            "const": "1"
          },
          "beta": {
            "type": "boolean",
            "const": true
          },
          "stav": {
            "type": "string",
            "enum": [
              "ok",
              "stara_data"
            ]
          },
          "vydano": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Kdy jsme výhled vydali."
          },
          "vytvoreno": {
            "type": "string",
            "format": "date-time",
            "description": "Kdy vznikl dokument."
          },
          "dalsi_aktualizace": {
            "type": "string",
            "format": "date-time",
            "description": "Nejbližší plánovaná obnova."
          },
          "stari_min": {
            "type": "integer",
            "minimum": 0
          },
          "znama_do": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Konec poslední vyhlášené hodiny."
          },
          "predpoved_do": {
            "type": "string",
            "format": "date-time",
            "description": "Konec předpovědi."
          }
        }
      },
      "Chyba": {
        "type": "object",
        "required": [
          "verze",
          "stav"
        ],
        "properties": {
          "verze": {
            "type": "string",
            "const": "1"
          },
          "stav": {
            "type": "string",
            "enum": [
              "neplatny_klic",
              "limit",
              "neplatny_parametr",
              "nedostupne",
              "nenalezeno"
            ]
          },
          "chyba": {
            "type": "string",
            "description": "Popis chyby česky."
          }
        }
      }
    }
  }
}
