Mezők és értékek

Ami minden entitásra áll: az értékek szabálya a válaszban és a kérésben, a dátum alakja és a mezők neve.

Az értékek

	A válaszban	A kérésben
üres érték	`null`: a szöveg, a dátum és a „nincs” jelentésű szám, például a hivatkozás `…Id`-je; a valódi `0` és `false` marad, az üres lista `[]`	a típus üres értéke ürít: a szöveg és a dátum `""`, a szám `0`, ahol a mező leírása szerint az a „nincs”, az igen/nem `false`; a kötelező mező nem üríthető
`null`	az üres érték	nem változtat, nem töröl — mint a kihagyott mező; kivétel az `updateMask`
kihagyott mező	nincs: minden mező jön, az üres is; a `list` a „Listában” jelűeket adja	nem változik — kivétel az `updateMask`; a `new`-ban a nem kötelező mező elhagyható
ismeretlen mező	hagyd figyelmen kívül — Új mezők és értékek	`400`: `Unknown field: …`, a paraméternél `Unknown parameter: …`
csak olvasható mező	jön	`400` (`Read-only field: …`), kivéve az `id`-t, amivel az `update` keres — a `get` válasza így csak az `updateMask`-kal küldhető vissza
típus	a mezőtábla szerint	kötött: a szám számként — form-alakban számjegyekből álló szövegként is —, az igen/nem `true` vagy `false`, a dátum a Dátum szerint; más típus `400`

Típusonként, a lists és a listitems mezőivel:

Típus — mező	Kihagyva vagy `null`	Ürítés	Érték
szöveg — `note`	nem változik	`""` — törli	`"VIP"`
dátum — `expirationDate`	nem változik	`""` — törli: a lista nem jár le	`"2026-12-31"`
időpont — `expiresAt`	nem változik	`""` — törli: a tétel nem jár le	`"2026-12-31T18:00:00+01:00"`
szám — `headerColumn2`	nem változik	`0` — törli: nincs másodlagos fejléc	`2` — a 2. oszlop
igen/nem — `disabled`	nem változik	nincs: a `false` érték, feloldja	`true` — tiltja

Dátum

A dátumnak két formátuma van. A válaszé API-kulcsonként választható, alapból ISO 8601. Bemenetben mindkettő jó, a kulcs választásától függetlenül.

	ISO 8601 — alapértelmezett	ApiV3 — a régi API formátuma
dátum	`2026-10-17`	`2026.10.17`
időpont	`2026-10-17T10:00:00+02:00` — eltolással	`2026.10.17 10:00:00` — eltolás nélkül

Bemenetben az eltolás nélküli időpontot — 2026-10-17T10:00:00 és 2026.10.17 10:00:00 — a rendszer helyi időnek veszi. A lekérdezés-paraméterben az eltolás + jele %2B-ként megy (…T10:00:00%2B02:00), különben szóköz lesz belőle.

A nevek

Hol	Név	Példa
a rekord saját mezői	`id` · `code` · `name`	`users/get?id=42` → `{ "id": 42, "name": "Kovács Anna", … }`
hivatkozás más rekordra	`<entitás>Id` · `<entitás>Code`, olvasva mellette `<entitás>Name`	`projectId` · `projectCode`
a hivatkozottnak nincs kódja	bemenetben a neve	`roleName` · `folderName`
beágyazott hivatkozás	ugyanígy	`[{ "userId": 42, "userName": "Kovács Anna" }]`
a létrehozó művelet válasza	`id`, a létrejött rekordé	`users/new` → `{ "id": 57 }` · `dial/ivr` → `{ "id": 8812345 }`
időpont	`…At`	`createdAt`
dátum	`…Date`; a rekord saját dátuma `date`	`expirationDate`
igen/nem	`true` / `false`, állapotot mondó melléknév	`disabled`
állapot	`status`, kisbetűs angol szó; csak olvasható, hacsak az entitás lapja nem mondja írhatónak	`active` · `disabled` · `locked`

Ha a hivatkozás azonosítója és neve is jön, az azonosító az erősebb.