GitJog — Hungarian legislation

Melyik § szabályozza X-et? Teljes szövegű keresés magyar szótövezéssel, vagy hivatkozás feloldása („Fftv. 18. §”, „2013. évi CXXII. törvény”). A találat a § teljes szövegét hozza (4000 karakterig) és a § URL-jét — egy körben citálható.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Keresőkifejezés vagy hivatkozás: „termőföld elővásárlási jog”, „Ptk. 6:272. §”, „2013. évi CXXII. törvény 18. §”, „Fftv.”"
    },
    "hatalyos": {
      "description": "Csak hatályos szöveg (alap: true). false: a már nem hatályos jogszabályok szövege is.",
      "type": "boolean"
    },
    "limit": {
      "description": "Találatok száma (alap 10, max 40).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "q"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Egy jogszabály egy §-a (horgony vagy §-szám szerint), opcionálisan egy adott napon hatályos szöveggel. § nélkül a jogszabály metaadatát, időállapot-listáját és tartalomjegyzékét adja (nem a teljes szöveget).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "A jogszabály slugja, pl. „2013-evi-cxxii-torveny-foldforgalmi” (a `kereses` adja)."
    },
    "horgony": {
      "description": "A § horgonya, pl. „18-sz-elovasarlasi-jog” (a `kereses` vagy a tartalomjegyzék adja).",
      "type": "string"
    },
    "paragrafus": {
      "description": "A § száma horgony helyett: „18. §”, „6:272. §”, „18/A. §”.",
      "type": "string"
    },
    "datum": {
      "description": "Időállapot napja (YYYY-MM-DD): az ezen a napon hatályos szöveg. Alap: a legutolsó.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Hatályba lépett módosítások listája az érintett §-ok régi/új szövegével — egy hívás elég egy értesítéshez. Figyeléshez: add meg a `felveve_utan` cursort (első hívásnál egy időbélyeg, utána a válasz `kovetkezo_felveve_utan` mezője) és szűrj `q`-val (címbeli szókezdet, pl. „termőföld|földek forgalm|Földalap”) vagy `slugs`-szal. Történeti kérdésre (`mi változott a Btk.-ban 2024-ben?`) a `since`/`until`/`slugs` szűrők valók.

{
  "type": "object",
  "properties": {
    "felveve_utan": {
      "description": "Cursor: ISO-8601 időbélyeg; csak az ezután a repóba került időállapotok. A válasz `kovetkezo_felveve_utan` mezőjét add vissza a következő hívásban.",
      "type": "string"
    },
    "since": {
      "description": "Hatálybalépés napjától (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "until": {
      "description": "Hatálybalépés napjáig (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "slugs": {
      "description": "Csak ezek a jogszabályok.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "q": {
      "description": "Jogszabálycímre/rövidítésre illesztett szókezdet (kisbetű- és ékezet-független), „|”-vel több alternatíva, többszavas tag is lehet: „termőföld|földek forgalm|Földalap”. A tag szó elején illeszkedik („föld” → „földek”, de nem „külföld”); a puszta „föld” túl tág (földgáz, földmérés is).",
      "type": "string"
    },
    "limit": {
      "description": "Tételek száma (alap 20, max 50).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Egy jogszabály két időállapotának összevetése: csak az eltérő §-ok, régi és új szöveggel, soronkénti blokkokkal. Az időállapotok napjait a `szakasz` (§ nélkül) vagy a `valtozasok` adja.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "A jogszabály slugja, pl. „2013-evi-cxxii-torveny-foldforgalmi” (a `kereses` adja)."
    },
    "tol": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "A korábbi időállapot napja (YYYY-MM-DD)."
    },
    "ig": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "A későbbi időállapot napja (YYYY-MM-DD)."
    },
    "horgony": {
      "description": "Csak ezt a §-t (horgony).",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "tol",
    "ig"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Keresés a magyar törvényekben; az eredmény id-jét a `fetch` várja.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Egy `search`-találat teljes szövege az id („slug#horgony”) alapján.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}