{
  "openapi": "3.0.0",
  "info": {
    "title": "LoopBack Application",
    "version": "1.0.0",
    "description": "# Popis API\n\nAPI poskytuje informace o volných pracovních místech v ČR evidovaných na úřadech práce.\n\nSoučástí informací o každém pracovním místu jsou:\n\n- Požadovaná profese - Název a zařazení profese\n- Pracoviště a kontakty\n- Název firmy\n- Místo výkonu práce\n- Komu se má zájemce o pozici hlásit\n- Vlastnosti volného místa\n- Druh pracovněprávního vztahu\n- Směnnost\n- Minimální požadovaný stupeň vzdělání\n- Dobu zaměstnání\n- Mzdové rozpětí\n- Popis požadovaných dovedností\n- Poznámky volnému místu\n- Datum poslední změny v informací o volném místu\n\nZdroj dat: <a href=\"https://portal.mpsv.cz/sz/download\" target=\"_blank\">https://portal.mpsv.cz/sz/download</a>\n\nMáte k API připomínky, potřebovali byste jej upravit nebo získávat jiná data? Napište nám je na info@apitalks.com, děkujeme.\n\n# Jak začít\n\nAPI Volných pracovních míst je postaveno na HTTPs a je RESTful, proto všechny cally přes HTTP selžou. Naše API má předvídatelné adresy URL zaměřené na zdroje, takže obsahují root URL <a href=\"https://api.apitalks.store\" target=\"\\_blank\">`https://api.apitalks.store`</a> a zkrácený název názvu API, například `/volna-pracovni-mista`. API requesty vrací standardní kódy HTTPs odpovědi, které indikují chyby a JSON-encoded odpovědi, pokud byl API call úspěšný. Můžete použít Vaši oblíbenou HTTP/REST knihovnu pro Váš programovací jazyk pro napojení na naše API, zároveň jsme pro Vás připravili ukázky request příkladů pro vybrané jazyky.\nAPI je pouze pro čtení. Nemůžete zapisovat zpět do databáze.\nAbyste si API vyzkoušeli, musíte se nejdříve registrovat. Po registraci Vám pošleme privátní API klíč. Naším cílem je vždy publikovat aktuální data. Proto se může stát, že změníme verzi API. Podívejte se na naše zásady verzování. Abyste měli vždy poslední informace, doporučujeme se přihlásit k odběru novinek pro poslední změny API.\n\n# Autentifikace\n\nNaše API jsou zabezpečena API klíčem a pro vygenerování API klíče se musíte registrovat. API klíč musí být uvedený v hlavičce requestu jako `x-api-key`, jinak API request selže.\n\n## API klíč\n\n| Typ schématu zabezpečení   | API klíč  |\n| -------------------------- | --------- |\n| Název parametru v hlavičce | x-api-key |\n\n# Query parametry\n\nJakmile integrujete naše API do Vaší aplikace a budete chtít začít posílat dotazy, tak můžete používat API URL bez query abyste získali všechna data z API (limit je nastaven na 30 záznamů na stránku), nebo můžete vložit `filter` parametr na konec API URL a vybrat jeden z možných query dotazů. Například, když budete chtít vyhledat záznam v databázi podle názvu a hodnoty parametru, pak bude vypadat konec API URL například následovně:\n\n| Filtrování    | Query dotaz                                             |\n| ------------- | ------------------------------------------------------- |\n| je rovno      | `/auta?filter={\"where\":{\"rok\":2000}}`                   |\n| je větší než  | `/auta?filter={\"where\":{\"rok\":{\"gt\":2000}}}`            |\n| je menší než  | `/auta?filter={\"where\":{\"rok\":{\"lt\":2000}}}`            |\n| více podmínek | `/auta?filter={\"where\":{\"rok\":2000,\"barva\":\"červená\"}}` |\n\n| Řazení        | Query dotaz                                                 |\n| ------------- | ----------------------------------------------------------- |\n| vzestupně     | `/auta?filter={\"limit\":30,\"order\":\"rok ASC\"}`               |\n| sestupně      | `/auta?filter={\"limit\":30,\"order\":\"rok DESC\"}`              |\n| více podmínek | `/auta?filter={\"limit\":30,\"order\":[\"rok DESC\",\"cena ASC\"]}` |\n\n| Stránkování | Query dotaz                           |\n| ----------- | ------------------------------------- |\n| 1. strana   | `/auta?filter={\"limit\":10,\"skip\":0}`  |\n| 2. strana   | `/auta?filter={\"limit\":10,\"skip\":10}` |\n| 3. strana   | `/auta?filter={\"limit\":10,\"skip\":20}` |\n\n# Chybové hlášky\n\nPro úspěšné provolání API používáme HTTP status kódy. Odpověď typu:\n\n- 2xx znamená úspěšné provedení operace\n- 4xx znamená chybu na klientovi\n- 5xx znamená chybu serveru\n\nV seznamu níže jsou uvedeny chybové hlášky, které se Vám mohou vrátit. Některé chyby je možné vyřešit opakováním stejného requestu. Ve sloupci “Opakovat” jsou označeny chyby, které je možné vyřešit opakováním requestu:\n\n- Ano - pošlete request znovu\n- Ano, pokud idempotentní - pošlete stejný request znovu, pokud je daná metoda implementována s idempotencí\n- Ne - vyřešte problém na straně klienta předtím než pošlete další request.\n\n| HTTP Status Kód | Chybová hláška                                                                                                                                                               | Opakovat                |\n| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |\n| 400             | Bad Request Exception                                                                                                                                                        | Ne                      |\n| 403             | Access Denied Exception                                                                                                                                                      | Ne                      |\n| 404             | Not Found Exception                                                                                                                                                          | Ne                      |\n| 409             | Conflict Exception                                                                                                                                                           | Ne                      |\n| 429             | Limit Exceeded Exception                                                                                                                                                     | Ne                      |\n| 429             | Too Many Requests Exception                                                                                                                                                  | Ne                      |\n| 502             | Bad Gateway Exception, usually for an incompatible output returned from a Lambda proxy integration backend and occasionally for out-of-order invocations due to heavy loads. | Ano, pokud idempotentní |\n| 503             | Service Unavailable Exception                                                                                                                                                | Ano                     |\n| 504             | Endpoint Request Timed-out Exception                                                                                                                                         | Ano, pokud idempotentní |\n\n## Ukázka chybové hlášky\n\nTato zpráva se ukáže, pokud jste nepoužili API klíč ve svém callu.\n\n```javascript\n{\n  message: \"Forbidden\";\n}\n```\n\n# Verzování\n\nV případě, že aktualizujeme API a znamená to zásadní změnu, která by způsobila nekompatibilitu s předchozí verzí, tak zajistíme že předchozí verze API bude dostupná následujících 30 dní. Díky tomu budete mít dostatek času, abyste mohli přejít na novou verzi API. O těchto změnách Vás budeme informovat dopředu na Váš e-mail.\n"
  },
  "paths": {
    "/volna-pracovni-mista/{id}": {
      "get": {
        "x-controller-name": "EmploymentOpenPositionsController",
        "x-operation-name": "findById",
        "tags": [
          "Volná pracovní místa"
        ],
        "x-code-samples": [
          {
            "lang": "cURL",
            "source": "curl --request GET https://api.apitalks.store/volna-pracovni-mista/10070810728 \\\n  --header 'x-api-key: <your api key here>'"
          },
          {
            "lang": "Node.js",
            "source": "const axios = require('axios');\n\naxios.request({\n  url: 'https://api.apitalks.store/volna-pracovni-mista/10070810728',\n  method: 'GET',\n  headers: {\n    'x-api-key': '1t845SyQrQa0c2YS9aIpG16kBT1jEcY19Q68dUss'\n  }\n})\n.then(response => {\n  console.log(response.data);\n})"
          },
          {
            "lang": "Python",
            "source": "import urllib.parse\nimport urllib.request\n\nurl = 'https://api.apitalks.store/volna-pracovni-mista/10070810728'\n\nreq = urllib.request.Request(url)\nreq.add_header('x-api-key', '1t845SyQrQa0c2YS9aIpG16kBT1jEcY19Q68dUss')\nresponse = urllib.request.urlopen(req)\ndata = response.read()\n\nprint(data)"
          }
        ],
        "responses": {
          "200": {
            "description": "\"volna-pracovni-mista\" model instance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmploymentOpenPositions"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "operationId": "volna-pracovni-mista-id"
      }
    },
    "/volna-pracovni-mista": {
      "get": {
        "x-controller-name": "EmploymentOpenPositionsController",
        "x-operation-name": "find",
        "tags": [
          "Volná pracovní místa"
        ],
        "x-code-samples": [
          {
            "lang": "cURL",
            "source": "curl --request GET https://api.apitalks.store/volna-pracovni-mista \\\n  --header 'x-api-key: <your api key here>'"
          },
          {
            "lang": "Node.js",
            "source": "const axios = require('axios');\n\naxios.request({\n  url: 'https://api.apitalks.store/volna-pracovni-mista',\n  method: 'GET',\n  headers: {\n    'x-api-key': '1t845SyQrQa0c2YS9aIpG16kBT1jEcY19Q68dUss'\n  }\n})\n.then(response => {\n  console.log(response.data);\n})"
          },
          {
            "lang": "Python",
            "source": "import urllib.parse\nimport urllib.request\n\nurl = 'https://api.apitalks.store/volna-pracovni-mista'\n\nreq = urllib.request.Request(url)\nreq.add_header('x-api-key', '1t845SyQrQa0c2YS9aIpG16kBT1jEcY19Q68dUss')\nresponse = urllib.request.urlopen(req)\ndata = response.read()\n\nprint(data)"
          }
        ],
        "responses": {
          "200": {
            "description": "Array of \"volna-pracovni-mista\" model instances",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EmploymentOpenPositions"
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "filter",
            "in": "query",
            "style": "deepObject",
            "explode": true,
            "schema": {
              "type": "object",
              "properties": {
                "where": {
                  "type": "object",
                  "$ref": "#/components/schemas/EmploymentOpenPositions"
                },
                "fields": {
                  "type": "object",
                  "properties": {
                    "uid": {
                      "description": "Id pozice",
                      "type": "boolean"
                    },
                    "celkemVm": {
                      "description": "Celkem těchto volných pozic",
                      "type": "boolean"
                    },
                    "zmena": {
                      "description": "Datum poslední změny",
                      "type": "boolean"
                    },
                    "jakKontaktovat": {
                      "description": "Číselné označení možného způsobu kontaktování",
                      "type": "boolean"
                    },
                    "autor": {
                      "description": "Autor popisu pozice",
                      "type": "boolean"
                    },
                    "AGENTURA_PRACE_PRIDELENI": {
                      "type": "boolean"
                    },
                    "PROFESE": {
                      "description": "Kód a název firmy",
                      "type": "boolean"
                    },
                    "FIRMA": {
                      "description": "Název a IČ firmy",
                      "type": "boolean"
                    },
                    "SMENNOST": {
                      "description": "",
                      "type": "boolean"
                    },
                    "MIN_VZDELANI": {
                      "description": "",
                      "type": "boolean"
                    },
                    "PRACPRAVNI_VZTAH": {
                      "description": "",
                      "type": "boolean"
                    },
                    "KONOS": {
                      "description": "",
                      "type": "boolean"
                    },
                    "PRACOVISTE": {
                      "description": "",
                      "type": "boolean"
                    },
                    "MZDA": {
                      "description": "",
                      "type": "boolean"
                    },
                    "PRAC_POMER": {
                      "description": "",
                      "type": "boolean"
                    },
                    "VHODNE_PRO": {
                      "description": "",
                      "type": "boolean"
                    },
                    "URAD_PRACE": {
                      "description": "",
                      "type": "boolean"
                    },
                    "MODRE_KARTY": {
                      "description": "",
                      "type": "boolean"
                    },
                    "ZAMEST_KARTY": {
                      "description": "",
                      "type": "boolean"
                    },
                    "VOLNE_MISTO": {
                      "description": "",
                      "type": "boolean"
                    },
                    "vyraditDne": {
                      "description": "Den vyřazení pozice ze seznamu",
                      "type": "boolean"
                    },
                    "POZNAMKA": {
                      "description": "Detailní popis pozice",
                      "type": "boolean"
                    },
                    "JAZYK": {
                      "description": "Kód a název jazyka, včetně kódu úrovně a názvu úrovně znalosti cizího jazyka nutného pro tuto pozici",
                      "type": "boolean"
                    },
                    "OBOR": {
                      "type": "boolean"
                    },
                    "DOVEDNOST": {
                      "description": "Kód a název dovednosti pro pozici",
                      "type": "boolean"
                    },
                    "VYHODA": {
                      "description": "Kód a název oboru pozice",
                      "type": "boolean"
                    },
                    "www": {
                      "description": "webové stránky zveřejnitele pozice",
                      "type": "boolean"
                    }
                  }
                },
                "offset": {
                  "type": "integer",
                  "minimum": 0
                },
                "limit": {
                  "type": "integer",
                  "minimum": 0
                },
                "skip": {
                  "type": "integer",
                  "minimum": 0
                },
                "order": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        ],
        "operationId": "volna-pracovni-mista"
      }
    }
  },
  "servers": [
    {
      "url": "https://api.apitalks.store"
    }
  ],
  "components": {
    "schemas": {
      "Profese": {
        "title": "Profese",
        "properties": {
          "kod": {
            "description": "Kód profese",
            "type": "string"
          },
          "nazev": {
            "description": "Název profese",
            "type": "string"
          },
          "doplnek": {
            "description": "Doplněk profese",
            "type": "string"
          }
        }
      },
      "Firma": {
        "title": "Firma",
        "properties": {
          "nazev": {
            "description": "Název firmy",
            "type": "string"
          },
          "ic": {
            "description": "Ič firmy",
            "type": "string"
          },
          "www": {
            "description": "Webová stránka firmy",
            "type": "string"
          }
        }
      },
      "Smennost": {
        "title": "Smennost",
        "properties": {
          "kod": {
            "description": "Kód pozice",
            "type": "string"
          },
          "nazev": {
            "description": "Název pozice",
            "type": "string"
          }
        }
      },
      "MinVzdelani": {
        "title": "MinVzdelani",
        "properties": {
          "kod": {
            "description": "Kód minimálně požadovaného vzdělání",
            "type": "string"
          },
          "nazev": {
            "description": "Název minimálně požadovaného vzdělání",
            "type": "string"
          }
        }
      },
      "PracpravniVztah": {
        "title": "PracpravniVztah",
        "properties": {
          "ppvztahPpPlny": {
            "type": "string"
          },
          "ppvztahPpZkrac": {
            "type": "string"
          },
          "ppvztahSp": {
            "type": "string"
          },
          "ppvztahDpp": {
            "type": "string"
          },
          "ppvztahDpc": {
            "type": "string"
          },
          "tydneHodinMin": {
            "type": "string"
          }
        }
      },
      "Konos": {
        "title": "Konos",
        "description": "Kontaktní údaje na zveřejnitele pozice",
        "properties": {
          "_": {
            "type": "string"
          },
          "jmeno": {
            "type": "string"
          },
          "prijmeni": {
            "type": "string"
          },
          "telefon": {
            "type": "string"
          },
          "email": {
            "type": "string"
          }
        }
      },
      "Pracoviste": {
        "title": "Pracoviste",
        "description": "Adresa místa pracoviště dané pozice",
        "properties": {
          "_": {
            "type": "string"
          },
          "neurcitaAdresa": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "okresKod": {
            "type": "string"
          },
          "okres": {
            "type": "string"
          },
          "obec": {
            "type": "string"
          },
          "cobce": {
            "type": "string"
          },
          "ulice": {
            "type": "string"
          },
          "cp": {
            "type": "string"
          },
          "psc": {
            "type": "string"
          },
          "posta": {
            "type": "string"
          },
          "nazev": {
            "type": "string"
          }
        }
      },
      "Mzda": {
        "title": "Mzda",
        "description": "Typ a výše minimální a maximální mzdy",
        "properties": {
          "min": {
            "type": "string"
          },
          "typMzdy": {
            "type": "string"
          }
        }
      },
      "PracPomer": {
        "title": "PracPomer",
        "description": "Data začátku a konce pracovního poměru",
        "properties": {
          "od": {
            "type": "string"
          }
        }
      },
      "VhodnePro": {
        "title": "VhodnePro",
        "description": "Označení pro koho je pozice vhodná",
        "properties": {
          "absolventySs": {
            "type": "string"
          },
          "absolventyVs": {
            "type": "string"
          },
          "ozp": {
            "type": "string"
          },
          "bezbar": {
            "type": "string"
          },
          "cizince": {
            "type": "string"
          },
          "azylanty": {
            "type": "string"
          }
        }
      },
      "UradPrace": {
        "title": "UradPrace",
        "description": "Kód a název úřadu práce",
        "properties": {
          "kod": {
            "type": "string"
          },
          "nazev": {
            "type": "string"
          }
        }
      },
      "ModreKarty": {
        "title": "ModreKarty",
        "description": "Počet modrých karet pro pozici",
        "properties": {
          "pocetVmProMk": {
            "type": "string"
          },
          "celkemVmProMk": {
            "type": "string"
          },
          "vmRezervProMk": {
            "type": "string"
          },
          "vmRezervProPodanMk": {
            "type": "string"
          },
          "vmRezervProVyhovMk": {
            "type": "string"
          },
          "vmRezervProVydanMk": {
            "type": "string"
          }
        }
      },
      "ZamestKarty": {
        "title": "ZamestKarty",
        "description": "Počet zaměstnaneckých karet pro pozici",
        "properties": {
          "pocetVmProZm": {
            "type": "string"
          },
          "celkemVmProZm": {
            "type": "string"
          },
          "vmRezervProZm": {
            "type": "string"
          },
          "vmRezervProPodanZm": {
            "type": "string"
          },
          "vmRezervProVyhovZm": {
            "type": "string"
          },
          "vmRezervProVydanZm": {
            "type": "string"
          },
          "jenDalsiZamZm": {
            "type": "string"
          }
        }
      },
      "VolneMisto": {
        "title": "VolneMisto"
      },
      "Obor": {
        "title": "Obor",
        "properties": {
          "kod": {
            "description": "Kód oboru",
            "type": "string"
          },
          "nazev": {
            "description": "Název oboru",
            "type": "string"
          }
        }
      },
      "EmploymentOpenPositions": {
        "VOLNE_MISTO": {
          "type": "object"
        },
        "title": "EmploymentOpenPositions",
        "properties": {
          "uid": {
            "description": "Id pozice",
            "type": "string"
          },
          "celkemVm": {
            "description": "Celkem těchto volných pozic",
            "type": "string"
          },
          "zmena": {
            "description": "Datum poslední změny",
            "type": "string"
          },
          "jakKontaktovat": {
            "description": "Číselné označení možného způsobu kontaktování",
            "type": "string"
          },
          "autor": {
            "description": "Autor popisu pozice",
            "type": "string"
          },
          "AGENTURA_PRACE_PRIDELENI": {
            "type": "string"
          },
          "PROFESE": {
            "$ref": "#/components/schemas/Profese"
          },
          "FIRMA": {
            "$ref": "#/components/schemas/Firma"
          },
          "SMENNOST": {
            "$ref": "#/components/schemas/Smennost"
          },
          "MIN_VZDELANI": {
            "$ref": "#/components/schemas/MinVzdelani"
          },
          "PRACPRAVNI_VZTAH": {
            "$ref": "#/components/schemas/PracpravniVztah"
          },
          "KONOS": {
            "$ref": "#/components/schemas/Konos"
          },
          "PRACOVISTE": {
            "$ref": "#/components/schemas/Pracoviste"
          },
          "MZDA": {
            "$ref": "#/components/schemas/Mzda"
          },
          "PRAC_POMER": {
            "$ref": "#/components/schemas/PracPomer"
          },
          "VHODNE_PRO": {
            "$ref": "#/components/schemas/VhodnePro"
          },
          "URAD_PRACE": {
            "$ref": "#/components/schemas/UradPrace"
          },
          "MODRE_KARTY": {
            "$ref": "#/components/schemas/ModreKarty"
          },
          "ZAMEST_KARTY": {
            "$ref": "#/components/schemas/ZamestKarty"
          },
          "VOLNE_MISTO": {
            "$ref": "#/components/schemas/VolneMisto"
          },
          "vyraditDne": {
            "description": "Den vyřazení pozice ze seznamu",
            "type": "string"
          },
          "POZNAMKA": {
            "description": "Detailní popis pozice",
            "type": "string"
          },
          "JAZYK": {
            "description": "Kód a název jazyka, včetně kódu úrovně a názvu úrovně znalosti cizího jazyka nutného pro tuto pozici",
            "type": "string"
          },
          "OBOR": {
            "$ref": "#/components/schemas/Obor"
          },
          "DOVEDNOST": {
            "description": "Kód a název dovednosti pro pozici",
            "type": "object"
          },
          "VYHODA": {
            "description": "Kód a název oboru pozice",
            "type": "object"
          },
          "www": {
            "description": "webové stránky zveřejnitele pozice",
            "type": "string"
          }
        },
        "required": [
          "uid"
        ]
      }
    }
  }
}