{"openapi":"3.1.0","info":{"title":"Remény Farm karrier API","version":"1.0.0","description":"A nyilvános tartalom és a jelentkezés teljes szerződése. A válaszértékeket mindig a felhívás `questions` mezője szerint kell elkészíteni. Minden hiba alakja `{ \"error\": <kód> }`."},"servers":[{"url":"https://karrier.remeny.farm"}],"paths":{"/api/content/opportunities/{slug}":{"get":{"summary":"Publikált felhívás lekérése","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","enum":["application/json","text/markdown"]}}],"responses":{"200":{"description":"A felhívás JSON vagy Markdown reprezentációja; a kettő ugyanabból a forrásból készül.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"opportunity_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"opportunity_version_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"kind":{"type":"string","enum":["job","talent","program"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"published_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"content":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160},"summary":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","minLength":1,"maxLength":20000},"location":{"type":"string","minLength":1,"maxLength":200},"employment_type":{"type":"string","minLength":1,"maxLength":100},"salary_min":{"type":"number","minimum":0},"salary_max":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"questions":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"short_text"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"long_text"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"number"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"boolean"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"single_choice"},"choices":{"minItems":2,"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":120}},"required":["id","label"],"additionalProperties":false}}},"required":["id","label","required","kind","choices"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"multi_choice"},"choices":{"minItems":2,"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":120}},"required":["id","label"],"additionalProperties":false}}},"required":["id","label","required","kind","choices"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"url"}},"required":["id","label","required","kind"],"additionalProperties":false}]}},"privacy_version":{"type":"string","minLength":1,"maxLength":80},"privacy_notice":{"type":"string","minLength":1,"maxLength":20000},"talent_pool_notice":{"type":"string","minLength":1,"maxLength":10000}},"required":["title","summary","description","questions","privacy_version","privacy_notice"],"additionalProperties":false}},"required":["opportunity_id","opportunity_version_id","slug","kind","version","published_at","content"],"additionalProperties":false}},"text/markdown":{"schema":{"type":"string"},"example":"# Telepvezető\n\nA felhívás összefoglalója…\n\n- Típus: Állás"}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}},"text/plain":{"schema":{"type":"string"},"example":"Nincs ilyen felhívás."}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}},"text/plain":{"schema":{"type":"string"},"example":"A felhívás most nem érhető el."}}}}}},"/api/application-intents":{"post":{"summary":"Jelentkezés indítása","description":"Az intent_token-t a kliens generálja, és sosem kerül vissza válaszban. A törzs legfeljebb 131072 bájt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"opportunity_version_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"intent_token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}},"required":["request_id","opportunity_version_id","intent_token"],"additionalProperties":false},"example":{"request_id":"11111111-1111-4111-8111-111111111111","opportunity_version_id":"22222222-2222-4222-8222-222222222222","intent_token":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"}}}},"responses":{"201":{"description":"A jelentkezés elindult; az expires_at-ig küldhető be.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"intent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["intent_id","expires_at"],"additionalProperties":false},"example":{"intent_id":"44444444-4444-4444-8444-444444444444","expires_at":"2026-10-04T13:00:00+00:00"}}}},"400":{"description":"Hibás kérés, mező vagy fájltartalom.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"invalid_request"}}}},"403":{"description":"A karrier szerver és az adatgazda közti kapcsolat hibás.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"forbidden"}}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}}}},"409":{"description":"Ütközés: már beküldött vagy megerősített jelentkezés, eltérő ismétlés, vagy egy már megerősített jelentkezés dokumentum-azonosítójának újrahasználata (ilyenkor új X-Document-Id kell).","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"conflict"}}}},"410":{"description":"Lejárt a jelentkezés, vagy a felhívás lezárult és nem fogad jelentkezést.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"expired"}}}},"413":{"description":"Túl nagy kéréstörzs vagy fájl.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"payload_too_large"}}}},"429":{"description":"Túl sok kérés; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"rate_limited"}}}},"500":{"description":"Váratlan hiba.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"internal_error"}}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}}}}}}},"/api/application-intents/{id}/documents":{"parameters":[{"name":"id","in":"path","required":true,"description":"A jelentkezés (intent) UUID-azonosítója.","schema":{"type":"string","format":"uuid"}}],"get":{"summary":"A feltöltött fájlok ellenőrzési állapota","security":[{"intentToken":[]}],"responses":{"200":{"description":"A jelentkezéshez feltöltött dokumentumok.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"documents":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"file_name":{"type":"string","minLength":1,"maxLength":240},"mime_type":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"file_size":{"type":"integer","exclusiveMinimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"validation_status":{"type":"string","enum":["pending","clean","quarantined"]}},"required":["document_id","file_name","mime_type","file_size","sha256","validation_status"],"additionalProperties":false}}},"required":["documents"],"additionalProperties":false},"example":{"documents":[{"document_id":"33333333-3333-4333-8333-333333333333","file_name":"oneletrajz.pdf","mime_type":"application/pdf","file_size":42816,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","validation_status":"pending"}]}}}},"400":{"description":"Hibás kérés, mező vagy fájltartalom.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"invalid_request"}}}},"401":{"description":"Hiányzó, hibás vagy ismeretlen token, illetve azonosító.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unauthorized"}}}},"403":{"description":"A karrier szerver és az adatgazda közti kapcsolat hibás.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"forbidden"}}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}}}},"410":{"description":"Lejárt a jelentkezés, vagy a felhívás lezárult és nem fogad jelentkezést.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"expired"}}}},"429":{"description":"Túl sok kérés; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"rate_limited"}}}},"500":{"description":"Váratlan hiba.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"internal_error"}}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}}}}}},"post":{"summary":"Dokumentum feltöltése nyers bináris törzzsel","description":"A `pending` állapot még nem elfogadás: a beküldés csak akkor megy át, ha minden fájl `clean`. Egy jelentkezéshez legfeljebb 5 dokumentum tartozhat.","security":[{"intentToken":[]}],"parameters":[{"name":"X-Document-Id","in":"header","required":true,"description":"A kliens által fájlonként egyszer generált UUID v4. Újrapróbáláskor ugyanaz, így a feltöltés idempotens; új jelentkezésnél új azonosító kell.","schema":{"type":"string","format":"uuid"}},{"name":"X-File-Name","in":"header","required":true,"description":"encodeURIComponent-tal kódolt fájlnév. A tárolt nevet a szerver képzi; a válasz azt adja vissza.","schema":{"type":"string","maxLength":720},"example":"oneletrajz.pdf"},{"name":"X-File-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]}}],"requestBody":{"required":true,"description":"Legfeljebb 4 MiB (4194304 bájt).","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary","maxLength":4194304}}}},"responses":{"201":{"description":"A fájl feltöltve; a biztonsági ellenőrzésig `pending`.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"document_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"file_name":{"type":"string","minLength":1,"maxLength":240},"mime_type":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"file_size":{"type":"integer","exclusiveMinimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"validation_status":{"type":"string","enum":["pending","clean","quarantined"]}},"required":["document_id","file_name","mime_type","file_size","sha256","validation_status"],"additionalProperties":false},"example":{"document_id":"33333333-3333-4333-8333-333333333333","file_name":"oneletrajz.pdf","mime_type":"application/pdf","file_size":42816,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","validation_status":"pending"}}}},"400":{"description":"Hibás kérés, mező vagy fájltartalom.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"invalid_request"}}}},"401":{"description":"Hiányzó, hibás vagy ismeretlen token, illetve azonosító.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unauthorized"}}}},"403":{"description":"A karrier szerver és az adatgazda közti kapcsolat hibás.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"forbidden"}}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}}}},"409":{"description":"Ütközés: már beküldött vagy megerősített jelentkezés, eltérő ismétlés, vagy egy már megerősített jelentkezés dokumentum-azonosítójának újrahasználata (ilyenkor új X-Document-Id kell).","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"conflict"}}}},"410":{"description":"Lejárt a jelentkezés, vagy a felhívás lezárult és nem fogad jelentkezést.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"expired"}}}},"413":{"description":"Túl nagy kéréstörzs vagy fájl.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"payload_too_large"}}}},"429":{"description":"Túl sok kérés; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"rate_limited"}}}},"500":{"description":"Váratlan hiba.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"internal_error"}}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}}}}}}},"/api/application-intents/{id}/submit":{"post":{"summary":"Jelentkezés beküldése megerősítésre","description":"A válaszokat a jelentkezéskor publikált felhívásverzió kérdései szerint ellenőrizzük. A beküldés után a jelentkező e-mailben kap megerősítő linket; az expires_at a link érvényessége.","security":[{"intentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"A jelentkezés (intent) UUID-azonosítója.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"opportunity_version_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"contact":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string","minLength":3,"maxLength":40}},"required":["name","email"],"additionalProperties":false},"answers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"question_id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"value":{}},"required":["question_id","value"],"additionalProperties":false}},"privacy_version":{"type":"string","minLength":1,"maxLength":80},"privacy_accepted":{"type":"boolean","const":true},"talent_pool_opt_in":{"type":"boolean"},"documents":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"file_name":{"type":"string","minLength":1,"maxLength":240},"mime_type":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"file_size":{"type":"integer","exclusiveMinimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["document_id","file_name","mime_type","file_size","sha256"],"additionalProperties":false}}},"required":["opportunity_version_id","contact","answers","privacy_version","privacy_accepted","talent_pool_opt_in","documents"],"additionalProperties":false},"example":{"opportunity_version_id":"22222222-2222-4222-8222-222222222222","contact":{"name":"Minta Jelölt","email":"jelolt@example.test"},"answers":[{"question_id":"experience","value":"Minta válasz"}],"privacy_version":"2026-10","privacy_accepted":true,"talent_pool_opt_in":false,"documents":[]}}}},"responses":{"200":{"description":"Beküldve; a jelentkezés csak az e-mailes megerősítés után végleges.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"intent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","const":"submitted"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["intent_id","state","expires_at"],"additionalProperties":false},"example":{"intent_id":"44444444-4444-4444-8444-444444444444","state":"submitted","expires_at":"2026-10-05T12:30:00+00:00"}}}},"400":{"description":"Hibás kérés, mező vagy fájltartalom.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"invalid_request"}}}},"401":{"description":"Hiányzó, hibás vagy ismeretlen token, illetve azonosító.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unauthorized"}}}},"403":{"description":"A karrier szerver és az adatgazda közti kapcsolat hibás.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"forbidden"}}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}}}},"409":{"description":"Ütközés: már beküldött vagy megerősített jelentkezés, eltérő ismétlés, vagy egy már megerősített jelentkezés dokumentum-azonosítójának újrahasználata (ilyenkor új X-Document-Id kell).","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"conflict"}}}},"410":{"description":"Lejárt a jelentkezés, vagy a felhívás lezárult és nem fogad jelentkezést.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"expired"}}}},"413":{"description":"Túl nagy kéréstörzs vagy fájl.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"payload_too_large"}}}},"429":{"description":"Túl sok kérés; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"rate_limited"}}}},"500":{"description":"Váratlan hiba.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"internal_error"}}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}}}}}}},"/api/application-intents/{id}/confirmation":{"parameters":[{"name":"id","in":"path","required":true,"description":"A jelentkezés (intent) UUID-azonosítója.","schema":{"type":"string","format":"uuid"}}],"get":{"summary":"A beküldött adatok előnézete; nem véglegesít","security":[{"confirmationToken":[]}],"responses":{"200":{"description":"A beküldött adatok és a beküldéskor publikált kérdések, hogy a válaszok címkével jelenjenek meg. Token nincs a válaszban.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payload":{"type":"object","properties":{"opportunity_version_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"contact":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string","minLength":3,"maxLength":40}},"required":["name","email"],"additionalProperties":false},"answers":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"question_id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"value":{}},"required":["question_id","value"],"additionalProperties":false}},"privacy_version":{"type":"string","minLength":1,"maxLength":80},"privacy_accepted":{"type":"boolean","const":true},"talent_pool_opt_in":{"type":"boolean"},"documents":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"file_name":{"type":"string","minLength":1,"maxLength":240},"mime_type":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"file_size":{"type":"integer","exclusiveMinimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["document_id","file_name","mime_type","file_size","sha256"],"additionalProperties":false}}},"required":["opportunity_version_id","contact","answers","privacy_version","privacy_accepted","talent_pool_opt_in","documents"],"additionalProperties":false},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"questions":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"short_text"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"long_text"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"number"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"boolean"}},"required":["id","label","required","kind"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"single_choice"},"choices":{"minItems":2,"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":120}},"required":["id","label"],"additionalProperties":false}}},"required":["id","label","required","kind","choices"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"multi_choice"},"choices":{"minItems":2,"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":120}},"required":["id","label"],"additionalProperties":false}}},"required":["id","label","required","kind","choices"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{1,62}$"},"label":{"type":"string","minLength":1,"maxLength":240},"help_text":{"type":"string","minLength":1,"maxLength":500},"required":{"type":"boolean"},"kind":{"type":"string","const":"url"}},"required":["id","label","required","kind"],"additionalProperties":false}]}}},"required":["payload","expires_at","questions"],"additionalProperties":false}}}},"400":{"description":"Hibás kérés, mező vagy fájltartalom.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"invalid_request"}}}},"401":{"description":"Hiányzó, hibás vagy ismeretlen token, illetve azonosító.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unauthorized"}}}},"403":{"description":"A karrier szerver és az adatgazda közti kapcsolat hibás.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"forbidden"}}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}}}},"409":{"description":"Ütközés: már beküldött vagy megerősített jelentkezés, eltérő ismétlés, vagy egy már megerősített jelentkezés dokumentum-azonosítójának újrahasználata (ilyenkor új X-Document-Id kell).","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"conflict"}}}},"410":{"description":"Lejárt a jelentkezés, vagy a felhívás lezárult és nem fogad jelentkezést.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"expired"}}}},"429":{"description":"Túl sok kérés; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"rate_limited"}}}},"500":{"description":"Váratlan hiba.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"internal_error"}}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}}}}}},"post":{"summary":"Jelentkezés véglegesítése","description":"Idempotens: a megismételt megerősítés ugyanazt az eredményt adja.","security":[{"confirmationToken":[]}],"responses":{"200":{"description":"A jelentkezés végleges. Token nincs a válaszban.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"application_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","const":"confirmed"}},"required":["application_id","state"],"additionalProperties":false},"example":{"application_id":"55555555-5555-4555-8555-555555555555","state":"confirmed"}}}},"400":{"description":"Hibás kérés, mező vagy fájltartalom.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"invalid_request"}}}},"401":{"description":"Hiányzó, hibás vagy ismeretlen token, illetve azonosító.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unauthorized"}}}},"403":{"description":"A karrier szerver és az adatgazda közti kapcsolat hibás.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"forbidden"}}}},"404":{"description":"Nincs ilyen publikált felhívás, vagy a jelentkezés most nem érhető el.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"not_found"}}}},"409":{"description":"Ütközés: már beküldött vagy megerősített jelentkezés, eltérő ismétlés, vagy egy már megerősített jelentkezés dokumentum-azonosítójának újrahasználata (ilyenkor új X-Document-Id kell).","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"conflict"}}}},"410":{"description":"Lejárt a jelentkezés, vagy a felhívás lezárult és nem fogad jelentkezést.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"expired"}}}},"429":{"description":"Túl sok kérés; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"rate_limited"}}}},"500":{"description":"Váratlan hiba.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"internal_error"}}}},"503":{"description":"A szolgáltatás átmenetileg nem érhető el; később újrapróbálható.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string","enum":["invalid_request","invalid_file","unauthorized","forbidden","not_found","expired","conflict","payload_too_large","rate_limited","unavailable","internal_error"]}},"required":["error"],"additionalProperties":false},"example":{"error":"unavailable"}}}}}}}},"components":{"securitySchemes":{"intentToken":{"type":"http","scheme":"bearer","bearerFormat":"43 karakteres base64url jelentkezési token","description":"A kliens generálja a jelentkezés indításakor; nem kerül vissza API-válaszban."},"confirmationToken":{"type":"http","scheme":"bearer","bearerFormat":"43 karakteres base64url megerősítő token","description":"Csak a jelentkezőnek küldött e-mailes linkből származhat; nyilvános válaszban nem jelenik meg."}}}}