diff --git a/metadata-schema/metadata.schema.json b/metadata-schema/metadata.schema.json
new file mode 100644
index 0000000000000000000000000000000000000000..cd072a0782d5076809442495197d37677b502bce
--- /dev/null
+++ b/metadata-schema/metadata.schema.json
@@ -0,0 +1,1108 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://fitko.uber.space/REPLACEME/metadata.schema.json",
+ "type": "object",
+ "title": "Application Metadata without ID",
+ "description": "Metadaten eines Antrags noch ohne ID, zum Anlegen eines neuen Antrags. Nach dem Zuweisen der `application-id` wird das Modell [Application Metadata](metadata.json) verwendet.",
+ "properties": {
+ "applicationId": {
+ "type": "string",
+ "pattern": "^[-_.A-Za-z0-9]+$",
+ "description": "ID des Antrags"
+ },
+ "applicants": {
+ "type": "array",
+ "items": {
+ "title": "Applicant",
+ "description": "Ein Antragsteller, entweder eine Organisation oder eine natürliche Person",
+ "type": "object",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/Applicant-person"
+ },
+ {
+ "$ref": "#/definitions/Applicant-organization"
+ }
+ ],
+ "discriminator": {
+ "propertyName": "type",
+ "mapping": {
+ "person": "#/definitions/Applicant-person",
+ "organization": "#/definitions/Applicant-organization"
+ }
+ }
+ }
+ },
+ "paymentInfo": {
+ "$ref": "#/definitions/Payment-info"
+ },
+ "publicServiceType": {
+ "$ref": "#/definitions/Public-service-type"
+ },
+ "contentStructure": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "docs"
+ ],
+ "properties": {
+ "data": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "schema": {
+ "$ref": "#/definitions/Schema"
+ }
+ },
+ "required": [
+ "schema"
+ ]
+ },
+ "docs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/Document"
+ }
+ }
+ }
+ },
+ "additionalReferenceInfo": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "subject": {
+ "type": "string"
+ },
+ "caseId": {
+ "type": "string"
+ },
+ "applicationDate": {
+ "type": "string",
+ "format": "date",
+ "description": "Antragsdatum"
+ }
+ }
+ }
+ },
+ "required": [
+ "contentStructure"
+ ],
+ "definitions": {
+ "Applicant-contact-info": {
+ "type": "object",
+ "title": "Applicant Contact Info",
+ "description": "Kontaktdaten des Antragstellers",
+ "additionalProperties": false,
+ "x-examples": {
+ "example-1": {
+ "electronicAdresses": [
+ {
+ "channelType": "Service-Account-Mailbox",
+ "address": "3b0c9c8c-0801-45f0-a331-2abfc9db78d0"
+ }
+ ],
+ "physicalAdress": {
+ "street": "Kurzer Weg",
+ "houseNumber": "7",
+ "postalCode": "12345",
+ "city": "Ankh-Morpork"
+ },
+ "telephones": [
+ {
+ "number": "+49 89 32168-42",
+ "mobile": true,
+ "description": "work"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "physicalAddress": {
+ "oneOf": [
+ {
+ "$ref": "#/definitions/Address-national"
+ },
+ {
+ "$ref": "#/definitions/Address-postbox"
+ },
+ {
+ "$ref": "#/definitions/Address-international"
+ }
+ ],
+ "description": "Physikalische (Post-)Adresse",
+ "discriminator": {
+ "propertyName": "type",
+ "mapping": {
+ "national": "#/definitions/Address-national",
+ "postbox": "#/definitions/Address-postbox",
+ "international": "#/definitions/Address-international"
+ }
+ }
+ },
+ "telephones": {
+ "type": "array",
+ "description": "Liste der Telefonnummern, außer Fax",
+ "items": {
+ "$ref": "#/definitions/Phone"
+ }
+ },
+ "electronicAddresses": {
+ "type": "array",
+ "description": "Elektronische Kontaktmöglkichkeiten, z.B. E-Mail",
+ "items": {
+ "type": "object",
+ "description": "",
+ "additionalProperties": false,
+ "properties": {
+ "channelType": {
+ "type": "string",
+ "enum": [
+ "Service-Account-Mailbox",
+ "De-Mail",
+ "E-Mail",
+ "Fax"
+ ],
+ "description": "Art der Kommunikationsmöglichkeit"
+ },
+ "address": {
+ "type": "string",
+ "description": "Kommunikationsadresse"
+ }
+ }
+ }
+ }
+ }
+ },
+ "Applicant-organization": {
+ "type": "object",
+ "title": "Applicant Organisation",
+ "description": "Antragsteller in Form von einer Organisation, z.B. einem Unternehmen",
+ "additionalProperties": false,
+ "properties": {
+ "identifier": {
+ "type": "array",
+ "description": "IDs für diese Organisation",
+ "items": {
+ "$ref": "#/definitions/Identifier"
+ }
+ },
+ "contactInfo": {
+ "$ref": "#/definitions/Applicant-contact-info"
+ },
+ "actingPerson": {
+ "type": "array",
+ "description": "Im Namen der Organisation auftretende natürliche Personen, wie z.B. Geschäftsführer, Vorstände oder Prokuristen",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "identityInfo": {
+ "$ref": "#/definitions/Natural-person"
+ },
+ "authentificationInfo": {
+ "$ref": "#/definitions/Authentification-info"
+ }
+ }
+ }
+ },
+ "organizationInfo": {
+ "type": "object",
+ "description": "Informationen über die Organisation",
+ "additionalProperties": false,
+ "properties": {
+ "legalName": {
+ "type": "string",
+ "description": "Name oder Bezeichnung - Der rechtliche Name einer Organisation. Der Name ist nicht zwingend eindeutig, um die Organisation zu identifizieren."
+ },
+ "organizationType": {
+ "type": "string",
+ "description": "Rechtsform der Organisation"
+ },
+ "registryCourt": {
+ "type": "string",
+ "description": "Registergericht"
+ },
+ "registryType": {
+ "type": "string",
+ "description": "Registerart - Die Registerart macht die Registernummer zur Identifizierung der Organisation innerhalb des Registergerichts eindeutig (z. B. HRA und HRB als Registerarten für das Handelsregister)."
+ },
+ "registryNumber": {
+ "type": "string",
+ "description": "Registernummer, z.B. vom Handelsregister"
+ },
+ "legalAddress": {
+ "oneOf": [
+ {
+ "$ref": "#/definitions/Address-national"
+ },
+ {
+ "$ref": "#/definitions/Address-postbox"
+ },
+ {
+ "$ref": "#/definitions/Address-international"
+ }
+ ],
+ "description": "Offizielle Adresse",
+ "discriminator": {
+ "propertyName": "type",
+ "mapping": {
+ "national": "#/definitions/Address-national",
+ "postbox": "#/definitions/Address-postbox",
+ "international": "#/definitions/Address-international"
+ }
+ }
+ },
+ "legalRepresentatives": {
+ "type": "array",
+ "description": "Namen der Mitglieder des Vertretungsorgans oder der gesetzlichen Vertreter",
+ "items": {
+ "$ref": "#/definitions/Individual"
+ }
+ }
+ }
+ },
+ "orgValidation": {
+ "type": "object",
+ "description": "Informationen, ob diese Organisation vom sendenden System identifiziert wurde",
+ "additionalProperties": false,
+ "properties": {
+ "method": {
+ "type": "string",
+ "description": "Identifizierungsmethode"
+ }
+ },
+ "required": [
+ "method"
+ ]
+ },
+ "type": {
+ "type": "string",
+ "enum": [
+ "organization"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ]
+ },
+ "Applicant-person": {
+ "type": "object",
+ "title": "Applicant Person",
+ "description": "Antragstellerdaten für eine natürliche Person",
+ "additionalProperties": false,
+ "properties": {
+ "identifier": {
+ "type": "array",
+ "description": "IDs der natürlichen Person",
+ "items": {
+ "$ref": "#/definitions/Identifier"
+ }
+ },
+ "authentificationInfo": {
+ "$ref": "#/definitions/Authentification-info"
+ },
+ "identityInfo": {
+ "$ref": "#/definitions/Natural-person"
+ },
+ "contactInfo": {
+ "$ref": "#/definitions/Applicant-contact-info"
+ },
+ "type": {
+ "type": "string",
+ "enum": [
+ "person"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ]
+ },
+ "Document": {
+ "type": "object",
+ "title": "Application Document",
+ "description": "Ein im Antrag (Application) enthaltenes Dokument (z.B. Antragsformular oder hochgeladene Anlage)",
+ "additionalProperties": false,
+ "properties": {
+ "purpose": {
+ "type": "string",
+ "enum": [
+ "form",
+ "attachment",
+ "report"
+ ],
+ "description": "Zweck/Art des Dokuments\n- form: Antragsformular\n- attachment: Anlage (Upload)\n- report: Vom System erzeugte Unterlage"
+ },
+ "size": {
+ "type": "integer",
+ "description": "Größe des Dokuments in Bytes"
+ },
+ "filename": {
+ "type": "string",
+ "description": "Ursprünglicher Dateiname bei Erzeugung oder Upload"
+ },
+ "description": {
+ "type": "string",
+ "description": "Optionale Beschreibung des Dokuments"
+ },
+ "lang": {
+ "$ref": "#/definitions/Language"
+ },
+ "hash": {
+ "type": "object",
+ "description": "Prüfsumme über den Inhalt des Dokuments zur Absicherung auf dem Transportweg",
+ "additionalProperties": false,
+ "properties": {
+ "algorithm": {
+ "type": "string",
+ "description": "Verwendeter Algorithmus",
+ "enum": [
+ "SHA-256",
+ "SHA-512"
+ ]
+ },
+ "digest": {
+ "type": "string",
+ "description": "Prüfsumme, hexadezimal codiert",
+ "pattern": "^[A-Fa-f0-9]{64}([A-Fa-f0-9]{64})?$"
+ }
+ },
+ "required": [
+ "algorithm",
+ "digest"
+ ]
+ },
+ "signature": {
+ "type": "string",
+ "pattern": "^[a-zA-Z0-9-_=]+$",
+ "description": "Sofern der Antragstellers dieses Dokument signiert hat, wird die Signatur hier base64url-encoded eingebettet"
+ },
+ "mimeType": {
+ "$ref": "#/definitions/Mime-type"
+ },
+ "docId": {
+ "type": "string",
+ "pattern": "^[-_.A-Za-z0-9]+$",
+ "description": "ID des Dokuments. Diese muss nur innerhalb des Antrags (Application) eindeutig sein. Es wird daher empfohlen, die IDs fortlaufend (1, 2 etc.) zu vergeben."
+ }
+ },
+ "required": [
+ "purpose",
+ "size",
+ "mimeType"
+ ]
+ },
+ "Payment-info": {
+ "type": "object",
+ "title": "Payment Info",
+ "description": "Informationen über eine im Antragsprozess erfolgte Bezahlung.",
+ "additionalProperties": false,
+ "properties": {
+ "reference": {
+ "type": "string",
+ "description": "Bezahlreferenz, z.B. ein Kassenzeichen"
+ },
+ "usage": {
+ "type": "string",
+ "description": "Verwendungszweck",
+ "maxLength": 27
+ },
+ "amount": {
+ "type": "number",
+ "minimum": 0.01,
+ "multipleOf": 0.01,
+ "description": "Geldbetrag"
+ },
+ "timestamp": {
+ "type": "string",
+ "description": "Zeitpunkt der Bezahlung",
+ "format": "date-time"
+ },
+ "status": {
+ "type": "string",
+ "description": "Status der Bezahlung",
+ "enum": [
+ "success",
+ "failed",
+ "open"
+ ]
+ },
+ "transaction": {
+ "type": "string",
+ "description": "Informationen zur Bezahltransaktion, z.B. eine Transaktions-ID"
+ }
+ },
+ "required": [
+ "usage",
+ "amount",
+ "status"
+ ],
+ "x-examples": {
+ "example-1": {
+ "reference": "TP/93/GDP",
+ "usage": "Gewerbeanmeldung",
+ "amount": 17.3,
+ "timestamp": "2020-03-03T12:38:23Z",
+ "status": "success",
+ "transaction": "1f77c5f9b759db9cdce59988b24974d465c7be5e462a6185485559ff6e2dea82"
+ }
+ }
+ },
+ "Public-service-type": {
+ "type": "object",
+ "title": "Verwaltungsleistung",
+ "description": "Beschreibung der Art der Verwaltungsleistung. Eine Verwaltungleistung sollte immer mit einer LeiKa-ID beschrieben werden. Ist für die gegebene Verwaltungsleistung keine LeiKa-ID vorhanden, kann die Verwaltungsleistung übergangsweise über die Angabe eines Schemas (`otherIdentifiers`) beschrieben werden.",
+ "additionalProperties": false,
+ "x-examples": {
+ "example-1": {
+ "name": "Gewerbeanmeldung",
+ "description": "Eine Gewerbeanmeldung ist immer dann notwendig, wenn Sie einen stehenden Gewerbebetrieb beginnen.",
+ "leikaId": "99050012104000",
+ "otherIdentifiers": [
+ {
+ "id": "8664844",
+ "schemeID": "service.niedersachsen.de",
+ "schemeName": "Serviceportal Niedersachsen"
+ },
+ {
+ "id": "354824",
+ "schemeID": "buerger.thueringen.de",
+ "schemeName": "Zuständigkeitsfinder Thüringen"
+ }
+ ]
+ },
+ "example-2": {
+ "name": "Gewerbeanmeldung",
+ "leikaId": "99050012104000"
+ }
+ },
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "Name/Bezeichnung der behördlichen Leistung"
+ },
+ "description": {
+ "type": "string",
+ "description": "(Kurz-)Beschreibung der behördlichen Leistung"
+ },
+ "otherIdentifiers": {
+ "type": "array",
+ "description": "Weitere Identifikatioren. Die ID wird in `content` abgelegt, zusätzlich sollten die Schema-Attribute zur Spezifikation des Gültigkeitsraumes verwendet werden.",
+ "items": {
+ "$ref": "#/definitions/Identifier"
+ }
+ },
+ "leikaId": {
+ "type": "string",
+ "pattern": "^[0-9]{2}([0-9]{3}){1,4}$",
+ "description": "ID aus dem Leistungskatalog (Leika)"
+ },
+ "legalBasis": {
+ "type": "string",
+ "description": "Rechtsgrundlage der Verwaltungsleistung. Dieses Feld dient zur Information für Verwaltungsmitarbeiter:innen und stellt insbesondere keine rechtsverbindliche Aussage dar."
+ }
+ },
+ "required": [
+ "name"
+ ]
+ },
+ "Schema": {
+ "type": "object",
+ "title": "Application Schema",
+ "description": "Strukturinformationen zu übertragbaren oder übertragenen Daten.",
+ "additionalProperties": false,
+ "x-examples": {
+ "example-1": {
+ "mimeType": "application/json",
+ "schemaSource": "none"
+ },
+ "example-2": {
+ "mimeType": "application/xml",
+ "schemaSource": "none"
+ },
+ "example-3": {
+ "mimeType": "application/xml",
+ "schemaSource": "fim",
+ "schemaId": "S99000001V1.0"
+ }
+ },
+ "properties": {
+ "schemaId": {
+ "type": "string",
+ "description": "ID des Schemas, abhängig von der ausgewählten Quelle."
+ },
+ "schemaSource": {
+ "type": "string",
+ "enum": [
+ "fim",
+ "none"
+ ],
+ "description": "Quelle, von der das Schema bezogen werden kann."
+ },
+ "mimeType": {
+ "type": "string",
+ "enum": [
+ "application/json",
+ "application/xml"
+ ],
+ "description": "Gibt das zulässige Format (JSON oder XML) der Fachdaten an."
+ },
+ "encoding": {
+ "type": "string",
+ "enum": [
+ "plain",
+ "base64",
+ "jwe"
+ ],
+ "description": "Übertragungscodierung:\n- `plain`: kein Encoding\n- `base64`: Inhalt base64-codieren\n- `jwe`: Inhalt mit JSON Web Encryption verschlüsseln"
+ }
+ },
+ "required": [
+ "schemaSource",
+ "mimeType",
+ "encoding"
+ ]
+ },
+ "Address-international": {
+ "type": "object",
+ "title": "International Address",
+ "description": "Eine internationale Adresse, bestehend aus ein bis fünf Adresszeilen.",
+ "additionalProperties": false,
+ "x-examples": {
+ "example-1": {
+ "type": "international",
+ "lines": [
+ "760 United Nations Plaza",
+ "Manhattan, New York City, New York 10017"
+ ],
+ "country": "368"
+ },
+ "example-2": {
+ "type": "international",
+ "lines": [
+ "Threadneedle Street",
+ "London EC2R 8AH"
+ ],
+ "country": "168"
+ }
+ },
+ "properties": {
+ "lines": {
+ "type": "array",
+ "maxItems": 5,
+ "minItems": 2,
+ "description": "Anschriftzeile",
+ "items": {
+ "type": "string",
+ "maxLength": 35
+ }
+ },
+ "country": {
+ "type": "string",
+ "description": "Staat gemäß Codeliste [https://www.xrepository.de/details/urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:staat](Codeliste Staat aus der Staats- und Gebietssystematik des Statistischen Bundesamtes)",
+ "minLength": 3,
+ "maxLength": 3,
+ "pattern": "^[0-9]{3}$"
+ },
+ "type": {
+ "type": "string",
+ "enum": [
+ "international"
+ ]
+ }
+ },
+ "required": [
+ "lines",
+ "country",
+ "type"
+ ]
+ },
+ "Address-national": {
+ "title": "National Address",
+ "description": "Eine nationale (deutsche) Adresse, bestehend aus Straße, Hausnummer, PLZ und Ort.",
+ "x-examples": {
+ "example-1": {
+ "type": "national",
+ "street": "Kurzer Weg",
+ "houseNumber": "7",
+ "postalCode": "12345",
+ "city": "Ankh-Morpork"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "street": {
+ "type": "string",
+ "description": "Straße",
+ "maxLength": 55
+ },
+ "houseNumber": {
+ "type": "string",
+ "description": "Hausnummer",
+ "maxLength": 9,
+ "pattern": "^[1-9][0-9]{0,3}(-[1-9][0-9]{0,3})?$"
+ },
+ "houseNumberSuffix": {
+ "type": "string",
+ "description": "Hausnummerzusatz",
+ "maxLength": 2,
+ "pattern": "^[A-Za-z0-9. ]*$"
+ },
+ "postalCode": {
+ "type": "string",
+ "description": "Postleitzahl",
+ "minLength": 5,
+ "maxLength": 5,
+ "pattern": "^([0]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{3}$"
+ },
+ "city": {
+ "type": "string",
+ "description": "Ort",
+ "maxLength": 50
+ },
+ "addressSupplement": {
+ "type": "string",
+ "description": "Adresszusatz"
+ },
+ "type": {
+ "type": "string",
+ "enum": [
+ "national"
+ ]
+ }
+ },
+ "required": [
+ "street",
+ "postalCode",
+ "city",
+ "type"
+ ]
+ },
+ "Address-postbox": {
+ "title": "Postfach Address",
+ "description": "Eine Adresse eines Postfachs.",
+ "x-examples": {
+ "example-1": {
+ "type": "postbox",
+ "postOfficeBox": "987",
+ "postalCode": "12345",
+ "city": "Ankh-Morpork"
+ }
+ },
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "postOfficeBox": {
+ "type": "string",
+ "description": "Postfach"
+ },
+ "postalCode": {
+ "type": "string",
+ "description": "Postleitzahl",
+ "minLength": 5,
+ "maxLength": 5,
+ "pattern": "^([0]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{3}$"
+ },
+ "city": {
+ "type": "string",
+ "description": "Ort",
+ "maxLength": 50
+ },
+ "type": {
+ "type": "string",
+ "enum": [
+ "postbox"
+ ]
+ }
+ },
+ "required": [
+ "postalCode",
+ "city",
+ "type"
+ ]
+ },
+ "Authentification-info": {
+ "type": "object",
+ "title": "Authentifikation",
+ "additionalProperties": false,
+ "description": "Informationen über die Authentifikation der Person.",
+ "x-examples": {
+ "example-1": {
+ "assuranceLevel": "high",
+ "authentificationMethod": "eID",
+ "timestamp": "2020-03-03T12:38:23Z"
+ }
+ },
+ "properties": {
+ "assuranceLevel": {
+ "type": "string",
+ "enum": [
+ "low",
+ "substantial",
+ "high"
+ ],
+ "description": "Vertrauensniveau"
+ },
+ "authentificationMethod": {
+ "type": "string",
+ "description": "Methode der Authentifikation",
+ "enum": [
+ "Authega",
+ "De-Mail",
+ "eID",
+ "E-Mail"
+ ]
+ },
+ "authentificationToken": {
+ "type": "object"
+ },
+ "timestamp": {
+ "type": "string",
+ "format": "date-time",
+ "description": "Zeitstempel der Authentifikation"
+ },
+ "authenticatedFields": {
+ "type": "array",
+ "minItems": 0,
+ "uniqueItems": true,
+ "description": "Liste der authentifizierten Felder in `identityInfo`",
+ "items": {
+ "type": "string",
+ "enum": [
+ "placeOfBirth",
+ "dateOfBirth",
+ "gender",
+ "nationality",
+ "artisticName",
+ "doctoralDegrees",
+ "birthName",
+ "givenName",
+ "familyName",
+ "placeOfResidence"
+ ]
+ }
+ }
+ },
+ "required": [
+ "assuranceLevel",
+ "authentificationMethod",
+ "authenticatedFields"
+ ]
+ },
+ "Identifier": {
+ "type": "object",
+ "title": "Identifier",
+ "description": "Identifiers are keys that are owned by either the sender, receiver or a third party. If the keys used are owned by either sender or receiver, no meta data has to be specified by means of attributes. The table below specifies the use of attributes for the identifier types when they are owned by a third party.",
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "A character string to identify and distinguish uniquely, one instance of an object in an identification scheme from all other objects in the same scheme together with relevant supplementary information."
+ },
+ "schemeURI": {
+ "type": "string",
+ "format": "uri",
+ "description": "Link to the location of the list scheme"
+ },
+ "schemeDataURI": {
+ "type": "string",
+ "format": "uri",
+ "description": "Link to the location of the list"
+ },
+ "schemeVersionId": {
+ "type": "string",
+ "description": "Version of the scheme"
+ },
+ "schemeAgencyName": {
+ "type": "string",
+ "description": "Specifies the name of the ID issuer"
+ },
+ "schemeAgencyId": {
+ "type": "string",
+ "description": "Specifies the ID of the ID issuer"
+ },
+ "schemeName": {
+ "type": "string",
+ "description": "Name of the scheme"
+ },
+ "schemeId": {
+ "type": "string",
+ "description": "Identifices the ID type"
+ }
+ },
+ "required": [
+ "id"
+ ],
+ "x-examples": {
+ "example-1": {
+ "id": "8664844",
+ "schemeId": "service.niedersachsen.de",
+ "schemeName": "Serviceportal Niedersachsen"
+ }
+ }
+ },
+ "Individual": {
+ "type": "object",
+ "title": "Individual",
+ "description": "Natürliche Person",
+ "additionalProperties": false,
+ "x-examples": {
+ "example-1": {
+ "formOfAddress": "Herr",
+ "doctoralDegrees": "Dr.",
+ "firstName": "Kunibert",
+ "lastName": "Vonundzu",
+ "contact": {
+ "telephones": [
+ {
+ "number": "+49 89 32168-42",
+ "mobile": false,
+ "description": "work"
+ },
+ {
+ "number": "+49 123 456789",
+ "mobile": true,
+ "description": "work"
+ }
+ ],
+ "email": "kunibert.vonundzu@example.com"
+ }
+ }
+ },
+ "properties": {
+ "formOfAddress": {
+ "type": "string",
+ "description": "Anrede der Person wie \"Herr\" oder \"Frau\""
+ },
+ "doctoralDegrees": {
+ "type": "string",
+ "description": "Titel der Person wie \"Dr.\" oder \"Prof.\""
+ },
+ "firstName": {
+ "type": "string",
+ "description": "Vorname der Person"
+ },
+ "lastName": {
+ "type": "string",
+ "description": "Nachname der Person"
+ },
+ "address": {
+ "description": "Adresse als Alternative (Choice) von nationaler und internationaler Adresse.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/Address-national"
+ },
+ {
+ "$ref": "#/definitions/Address-postbox"
+ },
+ {
+ "$ref": "#/definitions/Address-international"
+ }
+ ],
+ "discriminator": {
+ "propertyName": "type",
+ "mapping": {
+ "national": "./address-national.json",
+ "postbox": "./address-postbox.json",
+ "international": "./address-international.json"
+ }
+ }
+ },
+ "identifiers": {
+ "type": "array",
+ "description": "Externe Identifikatoren der Person",
+ "items": {
+ "$ref": "#/definitions/Identifier"
+ }
+ },
+ "contact": {
+ "type": "object",
+ "description": "Kontaktmöglichkeiten einer Person (natürliche Person oder Organisation)",
+ "additionalProperties": false,
+ "properties": {
+ "telephones": {
+ "type": "array",
+ "description": "Liste der Telefonnummern, außer Fax",
+ "items": {
+ "$ref": "#/definitions/Phone"
+ }
+ },
+ "email": {
+ "type": "string",
+ "format": "email",
+ "description": "E-Mail-Adresse"
+ },
+ "www": {
+ "type": "string",
+ "format": "uri",
+ "description": "Webadresse"
+ },
+ "telefax": {
+ "$ref": "#/definitions/Phone/properties/number"
+ }
+ }
+ }
+ }
+ },
+ "Language": {
+ "type": "object",
+ "title": "Language",
+ "description": "Angaben zur Sprache basierend auf dem IETF language tag. Es wird jedoch nur ein Subset unterstützt:\n- `lang`: Die Primary Language darf nur aus zwei oder drei Kleinbuchstaben bestehen (gemäß ISO 639-1 (2002), ISO 639-2 (1998), ISO 639-3 (2007) oder ISO 639-5 (2008))\n- `region`: Die Region muss aus zwei Großbuchstaben bestehen (gemäß ISO 3166-1 alpha-2)\n- `variant`: Sprachvariante (gemäß IANA Registry), derzeit wird nur `simple` unterstützt.",
+ "additionalProperties": false,
+ "properties": {
+ "lang": {
+ "type": "string",
+ "description": "primary language based on a two-letter language code from ISO 639-1 (2002) or a three-letter code from ISO 639-2 (1998), ISO 639-3 (2007) or ISO 639-5 (2008)",
+ "minLength": 2,
+ "maxLength": 3,
+ "pattern": "[a-z]{2,3}"
+ },
+ "region": {
+ "type": "string",
+ "description": "region based on a two-letter country code from ISO 3166-1 alpha-2",
+ "minLength": 2,
+ "maxLength": 2,
+ "pattern": "[A-Z]{2}"
+ },
+ "variant": {
+ "type": "string",
+ "enum": [
+ "simple"
+ ],
+ "description": "Subset der IANA language variant subtags\n- `simple`: Simplified form"
+ }
+ },
+ "required": [
+ "lang"
+ ],
+ "x-examples": {
+ "example-1": {
+ "lang": "de"
+ },
+ "example-2": {
+ "lang": "en",
+ "region": "GB"
+ },
+ "example-3": {
+ "lang": "de",
+ "region": "DE",
+ "variant": "simple"
+ }
+ }
+ },
+ "Mime-type": {
+ "type": "string",
+ "title": "MIME Type",
+ "description": "Internet Media Type gemäß RFC 2045, z.B. application/pdf.",
+ "example": "application/xml",
+ "pattern": "^[-\\w.]+/[-\\w.+]+$"
+ },
+ "Natural-person": {
+ "title": "Identity Information",
+ "description": "Informationen zu einer natürlichen Person. Wichtig: Wenn einzelne Felder für einen elektronischen Identitätsnachweis als Schriftform-Ersatz genutzt werden, MUSS geprüft werden, ob im Objekt `authentificationInfo` ein entsprechendes Authentifizierungslevel angegeben ist. Zusätzlich MUSS geprüft werden, ob die genutzten Felder im Object `authenticatedFields` enthalten sind.",
+ "type": "object",
+ "x-examples": {
+ "example-1": {
+ "dateOfBirth": "1970-09-13",
+ "gender": "m",
+ "givenName": "WERNER",
+ "familyName": "MUSTERMANN",
+ "placeOfResidence": {
+ "type": "national",
+ "street": "KURZER WEG 7",
+ "postalCode": "12345",
+ "city": "ANKH-MORPORK"
+ }
+ }
+ },
+ "properties": {
+ "placeOfBirth": {
+ "type": "string",
+ "description": "Geburtsort"
+ },
+ "dateOfBirth": {
+ "type": "string",
+ "format": "date",
+ "description": "Geburtsdatum"
+ },
+ "gender": {
+ "type": "string",
+ "enum": [
+ "m",
+ "w",
+ "x",
+ "d"
+ ],
+ "description": "Geschlecht (m=männlich, w=weiblich, x=keine Angabe, d=divers)"
+ },
+ "nationality": {
+ "type": "string",
+ "description": "Nationalität"
+ },
+ "artisticName": {
+ "type": "string",
+ "description": "Künstler- oder Ordensname"
+ },
+ "doctoralDegrees": {
+ "type": "string",
+ "description": "Akademischer Titel, z.B. \"Dr.\" oder \"Prof.\""
+ },
+ "birthName": {
+ "type": "string",
+ "description": "Geburtsname"
+ },
+ "givenName": {
+ "type": "string",
+ "description": "Vorname(n)"
+ },
+ "familyName": {
+ "type": "string",
+ "description": "Familienname"
+ },
+ "placeOfResidence": {
+ "$ref": "#/definitions/Address-national"
+ }
+ }
+ },
+ "Phone": {
+ "type": "object",
+ "title": "Phone",
+ "description": "Telefonnumer mit Zusatzinformationen",
+ "additionalProperties": false,
+ "properties": {
+ "number": {
+ "type": "string",
+ "title": "Phone Number",
+ "description": "Telefonnummer gemäß ITU E.123. Es soll das internationalen Format, z.B. \"+49 89 32168-42\" verwendet werden.",
+ "example": "+49 89 32168-42",
+ "maxLength": 23
+ },
+ "mobile": {
+ "type": "boolean",
+ "description": "Zeigt an, ob es sich um eine Mobilfunknummer handelt."
+ },
+ "description": {
+ "type": "string",
+ "description": "Beschreibung der Art der Telefonnummer"
+ }
+ },
+ "required": [
+ "number"
+ ],
+ "x-examples": {
+ "example-1": {
+ "number": "+49 89 32618",
+ "mobile": false,
+ "description": "Rosis Nummer"
+ },
+ "example-2": {
+ "number": "(089) 32618",
+ "mobile": false,
+ "description": "Rosis Nummer"
+ }
+ }
+ }
+ }
+}