schemes:person:nameandbirthdetails
Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
nameandbirthdetails
description
Das Schema person:nameandbirthdetails definiert:
Name:
- titles: Optionale Liste von Titeln (z. B. „Dr.“, „Prof.“, „Sir“).
- givenNames: Liste von Vornamen (mindestens ein Name erforderlich).
- familyNames: Liste von Nachnamen oder Familiennamen (mindestens ein Name erforderlich).
- suffixes: Optionale Namenszusätze (z. B. „Jr.“, „III“).
- preferredName: Der bevorzugte vollständige Name der Person.
- birthDate: Geburtsdatum im ISO-8601-Format (YYYY-MM-DD).
birthPlace:
- city: Stadt oder Ort des Geburtsortes.
- state: Optional, Bundesland oder Region.
- country: Länderkürzel nach ISO 3166-1 Alpha-2.
example
json notation
{
"name": {
"titles": ["Dr.", "Prof."],
"givenNames": ["Max", "Karl"],
"familyNames": ["Mustermann", "von Stottern"],
"birthNames": ["Tester", "von Helsinki"],
"suffixes": ["Jr."],
"preferredName": "Dr. Max Mustermann"
},
"birthDate": "1990-01-01",
"birthPlace": {
"city": "Berlin",
"state": "Berlin",
"country": "DE"
}
}
array notation
$person['nameandbirthdetails']['name']['titles'][0] = "Dr."; $person['nameandbirthdetails']['name']['titles'][1] = "Prof."; $person['nameandbirthdetails']['name']['givenNames'][0] = "Max"; $person['nameandbirthdetails']['name']['givenNames'][1] = "Karl"; $person['nameandbirthdetails']['name']['familyNames'][0] = "Mustermann"; $person['nameandbirthdetails']['name']['familyNames'][1] = "von Stottern"; $person['nameandbirthdetails']['name']['birthNames'][0] = "Tester"; $person['nameandbirthdetails']['name']['birthNames'][1] = "von Helsinki"; $person['nameandbirthdetails']['name']['suffixes'][0] = "Jr."; $person['nameandbirthdetails']['name']['preferredName'] = "Dr. Max Mustermann"; $person['nameandbirthdetails']['birthDate'] = "1990-01-01"; $person['nameandbirthdetails']['birthPlace']['city'] = "Berlin"; $person['nameandbirthdetails']['birthPlace']['state'] = "Berlin"; $person['nameandbirthdetails']['birthPlace']['country'] = "DE";
schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://b2base.eu/doku.php?id=schemes:person:nameandbirthdetails",
"title": "person:nameandbirthdetails",
"description": "A schema for representing a person's name, birth date, and birth place.",
"type": "object",
"properties": {
"name": {
"type": "object",
"description": "Information about the person's name.",
"properties": {
"titles": {
"type": "array",
"description": "Optional titles such as Dr., Prof., Sir.",
"items": {
"type": "string"
},
"example": ["Dr.", "Prof."]
},
"givenNames": {
"type": "array",
"description": "A list of given names.",
"items": {
"type": "string"
},
"minItems": 1,
"example": ["Max", "Karl"]
},
"familyNames": {
"type": "array",
"description": "A list of family or last names.",
"items": {
"type": "string"
},
"minItems": 1,
"example": ["Mustermann", "von Beispiel"]
},
"birthNames": {
"type": "array",
"description": "A list of birth or maiden names.",
"items": {
"type": "string"
},
"example": ["Mustermann", "von Beispiel"]
},
"suffixes": {
"type": "array",
"description": "Optional name suffixes such as Jr., Sr., III.",
"items": {
"type": "string"
},
"example": ["Jr.", "III"]
},
"preferredName": {
"type": "string",
"description": "The preferred full name of the person.",
"example": "Dr. Max Mustermann"
}
},
"required": ["givenNames", "familyNames"]
},
"birthDate": {
"type": "string",
"format": "date",
"description": "The person's date of birth in YYYY-MM-DD format.",
"example": "1990-01-01"
},
"birthPlace": {
"type": "object",
"description": "The person's place of birth.",
"properties": {
"city": {
"type": "string",
"description": "The name of the city or town.",
"example": "Berlin"
},
"state": {
"type": "string",
"description": "The name of the state or region.",
"example": "Berlin"
},
"country": {
"type": "string",
"description": "ISO 3166-1 Alpha-2 country code of the birth country.",
"example": "DE"
}
},
"required": ["city", "country"]
}
},
"required": ["name", "birthDate", "birthPlace"]
}
schemes/person/nameandbirthdetails.1733995504.txt.gz · Zuletzt geändert: (Externe Bearbeitung)
