{
  "openapi": "3.1.0",
  "info": {
    "title": "Życie w tygodniach",
    "version": "2025",
    "description": "Całe życie jako siatka tygodni: ile tygodni jest za osobą urodzoną w podanym dniu, ile przeciętnie przed nią według tablic trwania życia GUS za 2025 r. (przeciętne dalsze trwanie życia dla jej obecnego wieku, a nie od urodzenia) i jak tygodnie dzielą się na dzieciństwo, naukę, pracę do wieku emerytalnego i emeryturę. Tablice GUS, „Trwanie życia w 2025 r.” (27 lipca 2026 r.): ogolem (obie płcie łącznie), kobiety, mezczyzni. To średnie dla całej Polski z jednego roku, nie prognoza dla jednej osoby. Nauka od 7 lat (obowiązek szkolny), wiek emerytalny domyślnie ustawowy (kobiety 60, mężczyźni i ogolem 65 lat). Tygodnie za osobą z liczby dni od urodzenia, przed nią z przeciętnego dalszego trwania życia."
  },
  "servers": [
    {
      "url": "https://zyciewliczbach.pl"
    }
  ],
  "paths": {
    "/api/tygodnie/zycie": {
      "get": {
        "operationId": "zycieWTygodniach",
        "summary": "Tygodnie życia za i przed osobą urodzoną w podanym dniu",
        "parameters": [
          {
            "name": "urodzenie",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
              "description": "Data urodzenia RRRR-MM-DD albo RRRR-MM"
            }
          },
          {
            "name": "tablice",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ogolem",
                "kobiety",
                "mezczyzni"
              ],
              "default": "ogolem"
            }
          },
          {
            "name": "nauka",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19",
                "20",
                "21",
                "22",
                "23",
                "24",
                "25",
                "26",
                "27",
                "28",
                "29",
                "30",
                "31",
                "32",
                "33",
                "34",
                "35",
                "36",
                "37",
                "38",
                "39",
                "40"
              ],
              "default": "19"
            }
          },
          {
            "name": "emerytura",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19",
                "20",
                "21",
                "22",
                "23",
                "24",
                "25",
                "26",
                "27",
                "28",
                "29",
                "30",
                "31",
                "32",
                "33",
                "34",
                "35",
                "36",
                "37",
                "38",
                "39",
                "40",
                "41",
                "42",
                "43",
                "44",
                "45",
                "46",
                "47",
                "48",
                "49",
                "50",
                "51",
                "52",
                "53",
                "54",
                "55",
                "56",
                "57",
                "58",
                "59",
                "60",
                "61",
                "62",
                "63",
                "64",
                "65",
                "66",
                "67",
                "68",
                "69",
                "70",
                "71",
                "72",
                "73",
                "74",
                "75",
                "76",
                "77",
                "78",
                "79",
                "80"
              ]
            }
          },
          {
            "name": "dzis",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
              "description": "Data RRRR-MM-DD, od której liczyć"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Wynik",
            "content": {
              "application/json": {
                "example": {
                  "dzis": "2026-11-07",
                  "data_urodzenia": "1991-06-15",
                  "tablice": "ogolem",
                  "tablice_gus_za_rok": 2025,
                  "wiek_lat": 35,
                  "tydzien_zycia": 1848,
                  "tygodnie_za_toba": 1847,
                  "dalsze_trwanie_zycia_lat": 44.42,
                  "tygodnie_przed_toba": 2318,
                  "przecietna_dlugosc_zycia_lat": 79.8,
                  "polowa_dozywa_lat": 82.2,
                  "czesc_zycia_za_toba": 0.443,
                  "koniec_nauki_lat": 19,
                  "emerytura_od_lat": 65,
                  "emerytura_ustawowa": true,
                  "etapy": [
                    {
                      "etap": "dziecinstwo",
                      "od_lat": 0,
                      "do_lat": 7,
                      "tygodnie_za_toba": 365,
                      "tygodnie_przed_toba": 0
                    },
                    {
                      "etap": "nauka",
                      "od_lat": 7,
                      "do_lat": 19,
                      "tygodnie_za_toba": 626,
                      "tygodnie_przed_toba": 0
                    },
                    {
                      "etap": "praca",
                      "od_lat": 19,
                      "do_lat": 65,
                      "tygodnie_za_toba": 856,
                      "tygodnie_przed_toba": 1545
                    },
                    {
                      "etap": "emerytura",
                      "od_lat": 65,
                      "do_lat": null,
                      "tygodnie_za_toba": 0,
                      "tygodnie_przed_toba": 773
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Błędne parametry"
          },
          "429": {
            "description": "Za dużo zapytań, spróbuj za minutę"
          }
        }
      }
    }
  }
}