Czech Statistical Office (CZSO) Administrace API

Konfigurační parametry a soubory systému UDV

GitHub OpenAPI

Operations 8

GET /administrace/uzivatele Seznam osob - potenciálních vlastníků a kontaktů #
GET /administrace/skupiny Seznam skupin uživatelů #
GET /administrace/sady/{sadaKod}/vybery/{vyberKod}/export/aktualizace Požadavky na aktualizaci exportu výběru #
GET /administrace/sady/{sadaKod}/nkod/aktualizace Požadavky na aktualizaci exportu OpenData #
GET /administrace/sady/{sadaKod}/aktualizace Požadavky na aktualizaci sady #
GET /administrace/nastaveni Nastavení katalogu #
GET /administrace/mapy Mapy - seznam mapových podkladů #
GET /administrace/mapy/{kod}/geojson Mapy - obsah mapového podkladu #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/csu-gov-cz:csu-gov-cz-administrace-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

csu-gov-cz-administrace-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Csu Gov Cz Administrace API
  version: 1.28.1
  description: 'Operations tagged Administrace across 2 of this provider''s published API definitions: csu-gov-cz-katalog-api-docs.json, csu-gov-cz-datastat-catalog-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://data.csu.gov.cz/api/katalog/v1
  description: Generated server url
tags:
- name: Administrace
  description: Konfigurační parametry a soubory systému UDV
paths:
  /administrace/uzivatele:
    get:
      tags:
      - Administrace
      summary: Seznam osob - potenciálních vlastníků a kontaktů
      operationId: getAdministraceUzivatele
      parameters:
      - name: filtrText
        in: query
        description: Filtr na text ve jménu nebo přihlašovacím jménu osoby
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Osoba'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/skupiny:
    get:
      tags:
      - Administrace
      summary: Seznam skupin uživatelů
      operationId: getAdministraceSkupiny
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministraceSkupinaDto'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/sady/{sadaKod}/vybery/{vyberKod}/export/aktualizace:
    get:
      tags:
      - Administrace
      summary: Požadavky na aktualizaci exportu výběru
      operationId: getAdministraceVyberySdmxAktualizace
      parameters:
      - name: sadaKod
        in: path
        description: Kód sady
        required: true
        schema:
          type: string
      - name: vyberKod
        in: path
        description: Kód výběru
        required: true
        schema:
          type: string
      - name: sadaVerze
        in: query
        description: Verze sady
        required: true
        schema:
          type: string
      - name: vyberVerze
        in: query
        description: Verze výběru
        required: true
        schema:
          type: string
      - name: typExportu
        in: query
        description: Typ exportu
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Seznam exportů
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministracePozadavekAktualizaceExportu'
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AdministracePozadavekAktualizaceExportu'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AdministracePozadavekAktualizaceExportu'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/sady/{sadaKod}/nkod/aktualizace:
    get:
      tags:
      - Administrace
      summary: Požadavky na aktualizaci exportu OpenData
      operationId: getAdministraceSadyAktualizaceNkod
      parameters:
      - name: sadaKod
        in: path
        required: true
        schema:
          type: string
      - name: verze
        in: query
        description: Verze sady
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Seznam aktualizací
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministracePozadavekAktualizaceNKOD'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AdministracePozadavekAktualizaceNKOD'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/sady/{sadaKod}/aktualizace:
    get:
      tags:
      - Administrace
      summary: Požadavky na aktualizaci sady
      operationId: getAdministraceSadyAktualizace
      parameters:
      - name: sadaKod
        in: path
        required: true
        schema:
          type: string
      - name: verze
        in: query
        description: Verze sady
        required: true
        schema:
          type: string
      - name: prostredi
        in: query
        description: Filtruje výpis podle kódu "prostredi" (INT/EXT)
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Seznam aktualizací
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministracePozadavekAktualizaceSady'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AdministracePozadavekAktualizaceSady'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/nastaveni:
    get:
      tags:
      - Administrace
      summary: Nastavení katalogu
      operationId: getAdministraceNastaveni
      parameters:
      - name: kod
        in: query
        description: Kód parametru. Pro kódy oddělené tečkou se najdou i všechny podvarianty parametru (za tečkou)
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministracePolozkaNastaveni'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/mapy:
    get:
      tags:
      - Administrace
      summary: Mapy - seznam mapových podkladů
      operationId: getAdministraceMapy
      parameters:
      - name: Accept-Language
        in: header
        description: jazyk pro obsah odpovědi
        required: false
        schema:
          type: string
          default: cs
      - name: datum
        in: query
        description: Datum pro zobrazení dat. Nafiltruje mapy podle jejich platnosti.
        required: false
        schema:
          type: string
      - name: urovenUzemi
        in: query
        description: Kód úrovně územní dimenze. Nafiltruje seznam aby úroveň spadala pod základní dimenzi mapy
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdministraceMapa'
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
  /administrace/mapy/{kod}/geojson:
    get:
      tags:
      - Administrace
      summary: Mapy - obsah mapového podkladu
      operationId: getAdministraceMapyGeojson
      parameters:
      - name: kod
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://data.csu.gov.cz/api/katalog/v1
      description: Generated server url
components:
  schemas:
    AdministraceMapa:
      required:
      - kod
      - nazev
      type: object
      properties:
        kod:
          type: string
          description: Kód mapového podkladu - unikátní kód v rámci administrace map.
        nazev:
          type: string
          description: Název mapového podkladu
        urovenRamcova:
          type: string
          description: Kód rámcové úrovně dimenze - tj. informativní kód úrovně územní dimenze, do které je zakreslena základní úroveň. Např. STAT jako rámcová úroveň pro zobrazené KRAJ.
        urovenZakladni:
          type: string
          description: Kód první úrovně dimenze - pro kterou jsou data zobrazována - např. základní úroveň KRAJ zobrazuje hodnoty pro jednotlivé kraje v rámcové úrovni STAT
        platnostOd:
          type: string
          description: Platnost mapového podkladu (od data)
          format: date-time
        platnostDo:
          type: string
          description: Platnost mapového podkladu do data
          format: date-time
        mapovaniKoduDimenze:
          type: string
          description: Název položky / typu kódu území v geoJSON, na který se bude mapovat kód položky územní dimenze katalogu UDV
        pocetTrid:
          type: integer
          description: Požadovaný počet tříd (barev kartogramu) s ohledem na počet zobrazených území.
          format: int32
      description: Mapa uložená v konfiguraci systému - metadata
    AdministracePozadavekAktualizaceExportu:
      required:
      - editor
      - kodSady
      - kodVyberu
      - pozadavekCas
      - typExportu
      - verzeSady
      - verzeVyberu
      type: object
      properties:
        kodSady:
          type: string
          description: kód sady
        verzeSady:
          type: string
          description: verze sady
        kodVyberu:
          type: string
          description: kód výběru
        verzeVyberu:
          type: string
          description: verze výběru
        typExportu:
          type: string
          description: typ exportu
          enum:
          - INTERNAL
          - CENSUSHUB
        pozadavekCas:
          type: string
          description: čas požadavku
          format: date-time
        aktualizaceCas:
          type: string
          description: Čas aktualizace
          format: date-time
        editor:
          $ref: '#/components/schemas/Osoba'
      description: Požadavek na aktualizaci exportu (např. SDMX)
    AdministracePozadavekAktualizaceSady:
      required:
      - kod
      - pozadavekCas
      - typAktualizace
      - verze
      - zdrojPozadavku
      type: object
      properties:
        kod:
          type: string
          description: kód sady
        verze:
          type: string
          description: verze sady
        typAktualizace:
          type: string
          description: Plná nebo přírůstková aktualizace dat
          enum:
          - FULL
          - INCREMENT
        zdrojPozadavku:
          type: string
          description: Zdroj požadavku CATALOG / ETL
        pozadavekCas:
          type: string
          description: čas požadavku
          format: date-time
        aktualizaceCas:
          type: string
          description: Čas aktualizace
          format: date-time
        stornoCas:
          type: string
          description: Čas požadavku na storno
          format: date-time
        hashDefinice:
          type: string
          description: MD5 hash definice sady v okamžiku požadavku na aktualizaci (zahrnuje kódy sady, ukazatelů, dimenzí)
        editor:
          $ref: '#/components/schemas/Osoba'
        stavZpracovani:
          type: string
          description: Stav zpracování (READY" | "RUNNING" | "OK" | "ERROR" | "KILLED" | "SCHEDULED" | "SCHEDULED_KILL)
        logZpracovani:
          type: string
          description: Logy zpracování přípravy sady - primárně zdůvodnění chyby
        davky:
          type: array
          description: Kódy zdrojových dávek v nichž byla obsažena naplněná data.
          items:
            type: string
            description: Kódy zdrojových dávek v nichž byla obsažena naplněná data.
        prostredi:
          type: string
          description: Označení prostředí  (INT/EXT)
      description: Požadavek na aktualizaci obsahu sady.
    AdministracePolozkaKomplexni:
      type: object
      properties:
        json:
          type: string
          description: JSON objekt
        schema:
          type: string
          description: Název JSON schématu pro položku konfigurace - schéma je součástí dokumentace
      description: Komplexní konfigurace v podobě JSON objektu - např. množina nabízených hodnot (číselník) jako array,  strukturovaný objekt s více souvisejícími poli nastavení. Vrací se pouze pokud má pro daný kód komplexní hodnota smysl.
    AdministracePozadavekAktualizaceNKOD:
      required:
      - kod
      - pozadavekCas
      - typAktualizace
      - verze
      - zdrojPozadavku
      type: object
      properties:
        kod:
          type: string
          description: kód sady
        verze:
          type: string
          description: verze sady
        typAktualizace:
          type: string
          description: Plná nebo přírůstková aktualizace dat
          enum:
          - METADATA
          - ALL
        zdrojPozadavku:
          type: string
          description: Zdroj požadavku CATALOG / ETL
        pozadavekCas:
          type: string
          description: čas požadavku
          format: date-time
        aktualizaceCas:
          type: string
          description: Čas aktualizace
          format: date-time
        editor:
          $ref: '#/components/schemas/Osoba'
        stavZpracovani:
          type: string
          description: Stav zpracování ("READY" / "RUNNING" / "OK" / "ERROR" / "SCHEDULED" / "CANCELED")
        logZpracovani:
          type: string
          description: Logy zpracování přípravy sady - primárně zdůvodnění chyby
      description: Požadavek na aktualizaci obsahu exportu NKOD.
    AdministracePolozkaNastaveni:
      required:
      - kod
      type: object
      properties:
        kod:
          type: string
          description: Kód konfigurační položky
          example: permissions.restrictedCatalogLevels
        hodnota:
          type: string
          description: Hodnota konfigurační položky, pokud je to jednoduchá textová nebo číselná položka
        komplexniHodnota:
          $ref: '#/components/schemas/AdministracePolozkaKomplexni'
      description: Položka konfigurace katalogu nebo jiného modulu UDV
    Osoba:
      required:
      - login
      type: object
      properties:
        login:
          type: string
        plneJmeno:
          type: string
        eMail:
          type: string
        nazevOrganizace:
          type: string
      description: Atributy osoby působící v nějaké roli k entitě katalogu (vlastník, kontakt)
    AdministraceSkupinaDto:
      required:
      - kod
      type: object
      properties:
        kod:
          type: string
          description: Kód skupiny
        nazev:
          type: string
          description: Název skupiny
x-refined-from:
- csu-gov-cz-katalog-api-docs.json
- csu-gov-cz-datastat-catalog-openapi.yml