Dokumentation JSON-API für News-Datensätze (Version 1)
Inhalt
Format
Diese JSON-API stellt News-Datensätze und einige ihrer Relationen als UTF-8-kodiertes JSON-Objekt zur Verfügung. Es handelt sich um einen reinen Lese-Zugriff. Eine Authentifizierung ist nicht notwendig.
Aufruf
Für die Abfrage der News-Datensätze kann folgende URL aufgerufen werden:
https://www.wankendorfer.de/jsonapi/v1/news/
Beispiel-Ergebnis eines JSON-Objektes
{
"amountOfRecords": 3,
"news": [
{
"uid": 3,
"title": "Ausfall des Kinderferiencamps 2020",
"teaser": "",
"bodytext": "\u003Cp\u003ELiebe Eltern, liebe Kinder,\u003Cbr /\u003E aufgrund der aktuellen Coronapandemie und unserer F\u00fcrsorgepflicht als Veranstalter m\u00fcssen wir das Kinder\u0026shy;feriencamp 2020 schweren Herzens absagen. Wir haben bis zuletzt gehofft, das Camp auch in diesem Jahr durchf\u00fchren zu k\u00f6nnen. Die weitere Entwicklung der Pandemie ist aber leider zum gegenw\u00e4rtigen Zeitpunkt f\u00fcr uns nicht absehbar und die Sicherheit der Kinder und Betreuer geht nun einmal vor.\u003Cbr /\u003E Die Eltern, die bereits ihren Eigenanteil an uns \u00fcberwiesen haben, erhalten diesen selbstverst\u00e4ndlich umgehend zur\u00fcck. Bei R\u00fcckfragen k\u00f6nnen Sie sich gern an \u003Cstrong\u003EFrau Susanne B\u00f6ckmann\u003C/strong\u003E (Tel. 0431 2005-289, s.boeckmann@wankendorfer.de) wenden.\u003Cbr /\u003E Wir sind zuversichtlich, dass wir das beliebte Kinderferiencamp 2021 wieder durch\u0026shy;f\u00fchren k\u00f6nnen und w\u00fcnschen Ihnen sowie Ihren Angeh\u00f6rigen, dass Sie diese schwierige Zeit wohlbehalten \u00fcberstehen.\u003Cbr /\u003E Bleiben Sie gesund!\u003C/p\u003E\r\n\r\n",
"datetime": 1585692000,
"link": "https://www.wankendorfer.de/news-detail/ausfall-des-kinderferiencamps-2020/",
"image": {
"uid": 100,
"tstamp": 1627652079,
"name": "unsplash_dqgmhzeio7g.jpg",
"sha1": "70dbcd0b024b7f0c18cd65e9be7bcc845168e28b",
"title": "",
"description": null,
"alternative": null,
"source": "https://www.wankendorfer.de/fileadmin/user_upload/unsplash_dqgmhzeio7g.jpg"
},
"categories": [
5,
6,
1
],
"contactPersons": [
403
]
},
{
"uid": 4,
"title": "Die neue Gustav-B\u00f6hm-Siedlung",
"teaser": "Quartierentwicklung in Bad Segeberg\r\n\r\nVor genau 70 Jahren entstand auf dem ehemaligen Brachland an der Hamburger Stra\u00dfe die S\u00fcdstadt von Bad Segeberg mit der Gustav-B\u00f6hm-Siedlung. Was damals als modern galt, ist heute in die Jahre gekommen. Die Wohnungen in der Siedlung sind aufgrund der vorhandenen Wohnungsgrundrisse und wegen des hohen und umfassenden Modernisierungsbedarfs nicht mehr zukunftsf\u00e4hig. Eine Sanierung des bestehenden Bestandes kam deshalb nach eingehender Pr\u00fcfung f\u00fcr die wankendorfer nicht in Betracht und so entschied man sich f\u00fcr Abriss und Neubau.",
"bodytext": "\u003Cp\u003E\u003Cstrong\u003EBewegte Geschichte\u003C/strong\u003E\u003C/p\u003E\r\n\u003Cp\u003E1945 blickte die Welt auf einen verheerenden Krieg zur\u00fcck. In Deutschland war ein Viertel der Wohnungen zerst\u00f6rt oder schwer besch\u00e4digt. Ausgebombte, Kriegswaisen, Fl\u00fcchtlinge, Vertriebene und Heimkehrer suchten verzweifelt nach einer Unterkunft. Es herrschte echte Wohnungsnot im ganzen Land.\u003C/p\u003E\r\n\u003Cp\u003EIm Jahr 1947 k\u00fcndigte der damalige US-Au\u00dfenminister George C. Marshall ein umfangreiches finanzielles Hilfsprogramm zum Wiederaufbau Europas an, das unter seinem Namen in die Geschichte eingehen sollte: Das \u003Cstrong\u003EEuropean Recovery Program (ERP)\u003C/strong\u003E wurde sp\u00e4ter von allen nur noch als Marshallplan bezeichnet.\u003C/p\u003E\r\n\u003Cp\u003EIn Bad Segeberg hatte es der Sozialdemokrat und Gewerkschaftssekret\u00e4r Gustav B\u00f6hm durch hartn\u00e4ckige Antragstellung geschafft, Mittel aus ebendiesem Marshallplan f\u00fcr die neue Siedlung in der S\u00fcdstadt zu beschaffen. Und so kam es am 3. Mai 1950 zum ersten Spatenstich f\u00fcr das Quartier mit 200 Wohnungen. Bereits Ende des Jahres konnten die ersten Wohnungen bezogen werden. Gustav B\u00f6hm hat dies leider nicht mehr erlebt, da er bereits am 12. M\u00e4rz 1950 verstarb. Ihm zu Ehren wurde die ERP-Siedlung zwei Jahre sp\u00e4ter von der Stadtvertretung offiziell in Gustav-B\u00f6hm-Siedlung umbenannt. Seither halten sich beide Bezeichnungen, wenn von der Siedlung mit dem seinerzeit so dringend ben\u00f6tigten Wohnraum die Rede ist.\u003C/p\u003E\r\n\u003Cp\u003E\u003Cstrong\u003EEin neues Quartier entsteht\u003C/strong\u003E\u003C/p\u003E\r\n\u003Cp\u003EIn Abstimmung mit der Stadt Bad Segeberg und dem Innenministerium des Landes Schleswig-Holstein soll nun der schrittweise R\u00fcckbau der Wohnanlage und die Errichtung zeitgem\u00e4\u00dfer Wohnungen in mehreren Bauabschnitten erfolgen. Mehr noch: Mit der neuen Siedlung wird ein nach vielen Gesichtspunkten zukunftsorientiertes Quartier entstehen, an dem auch der Namenspate Gustav B\u00f6hm seine Freude gehabt h\u00e4tte.\u003C/p\u003E\r\n\u003Cp\u003ENach dem derzeitigen Planungsstand entstehen \u003Cstrong\u003Ein 13 Wohngeb\u00e4uden \u003C/strong\u003Einsgesamt\u003Cstrong\u003E 236 neue Wohnungen\u003C/strong\u003E. Diese werden sich in unterschiedlichen Geb\u00e4udetypen mit zwei bis drei Vollgeschossen zuz\u00fcglich eines Staffelgeschosses befinden. Die Flachd\u00e4cher der Geb\u00e4ude erhalten Dachbegr\u00fcnungen.\u003C/p\u003E\r\n\u003Cp\u003EBei den Wohnungen wird es einen Mix aus verschiedenen Wohnungsgr\u00f6\u00dfen von zwei bis vier Zimmern mit \u003Cstrong\u003Eca. 50 bis ca. 90 Quadratmetern Wohnfl\u00e4che\u003C/strong\u003E geben, die barrierefrei \u00fcber Aufzugsanlagen erreicht werden k\u00f6nnen. Gut ausgestattete Einbauk\u00fcchen und gro\u00dfz\u00fcgige B\u00e4der geh\u00f6ren ebenso zum Standard wie eine Fu\u00dfbodenheizung.\u003C/p\u003E\r\n\u003Cp\u003EMindestens 30 Prozent des neuen Wohnraums sollen im Rahmen der sozialen Wohnraumf\u00f6rderung errichtet werden. Nach den aktuellen F\u00f6rderbedingungen des Landes Schleswig-Holstein betr\u00e4gt die h\u00f6chstzul\u00e4ssige Nettokaltmiete f\u00fcr diese Wohnungen \u003Cstrong\u003E5,95 \u20ac/m\u00b2 \u003C/strong\u003Eim ersten und \u003Cstrong\u003E8,00 \u20ac/m\u00b2 \u003C/strong\u003Eim zweiten F\u00f6rderweg. In einem weiteren Geb\u00e4ude werden eine \u003Cstrong\u003EKindertagesst\u00e4tte\u003C/strong\u003E sowie die bereits vorhandenen Angebote \u003Cstrong\u003E\u201eHaus f\u00fcr Kinder\u201c\u003C/strong\u003E und \u003Cstrong\u003E\u201eFahrradwerkstatt\u201c\u003C/strong\u003E untergebracht sein. Durch die zum Gro\u00dfteil erhaltenen B\u00e4ume und gezielte Neuanpflanzungen wird das Quartier einen park\u00e4hnlichen Charakter bekommen.\u003C/p\u003E\r\n\u003Cp\u003E\u003Cstrong\u003ENachhaltig und zukunftsorientiert\u003C/strong\u003E\u003C/p\u003E\r\n\u003Cp\u003EDer Autoverkehr f\u00fcr die Anlieger beschr\u00e4nkt sich auf den Randbereich des Quartiers und es soll ein \u003Cstrong\u003ECar-Sharing-Angebot\u003C/strong\u003E geben. Dar\u00fcber hinaus wird auch die Nutzung von Fahrr\u00e4dern gef\u00f6rdert, indem in die einzelnen Wohnh\u00e4user spezielle \u003Cstrong\u003EFahrradr\u00e4ume mit E-Ladestationen\u003C/strong\u003E integriert werden. Auch im Hinblick auf den Klimaschutz wird die neue Gustav-B\u00f6hm-Siedlung zukunftsorientiert und nachhaltig geplant. Neben einer zeitgem\u00e4\u00dfen Geb\u00e4udeh\u00fclle und Geb\u00e4udetechnik kann auch eine Energieversorgung mit Photovoltaikanlagen eine L\u00f6sung sein.\u003C/p\u003E\r\n\u003Cp\u003E\u003Cstrong\u003EIm n\u00e4chsten Jahr geht\u2019s los\u003C/strong\u003E\u003C/p\u003E\r\n\u003Cp\u003EFr\u00fchestens im Jahr 2021 wird mit dem Abriss der ersten Geb\u00e4ude begonnen. Das Projekt wird sich dann mit dem jeweiligen \u003Cstrong\u003ENeubau\u003C/strong\u003E auf den ber\u00e4umten Fl\u00e4chen in mehreren Abschnitten \u003Cstrong\u003Ebis voraussichtlich zum Jahr 2026\u003C/strong\u003E erstrecken. F\u00fcr die ersten der derzeit noch 145 Mietparteien im Quartier wird bereits in diesem Jahr mit der Vermittlung von alternativem Wohnraum begonnen. Im pers\u00f6nlichen Gespr\u00e4ch im Stadtb\u00fcro oder in einem hierf\u00fcr eigens vor Ort eingerichteten Informationsb\u00fcro soll f\u00fcr jeden eine individuell passende L\u00f6sung gefunden werden. Bis die betroffenen Mieter eine neue Wohnung beziehen k\u00f6nnen, werden die derzeitigen Wohnungen nat\u00fcrlich in einem sicheren und funktional einwandfreien Zustand gehalten.\u003C/p\u003E\r\n\u003Cp\u003EWenn das Quartier dann vollst\u00e4ndig neu erbaut ist, wird an die vormalige Siedlung erinnert, indem der Grundriss eines einstigen Siedlungshauses im Rahmen der Gestaltung der Au\u00dfenanlagen Ber\u00fccksichtigung findet. Auf jeden Fall wird \u003Cstrong\u003Edie neue Gustav-B\u00f6hm-Siedlung\u003C/strong\u003E f\u00fcr die Mitglieder und Mieter der wankendorfer als auch f\u00fcr die Stadt Bad Segeberg ein Plus an Lebensqualit\u00e4t sein.\u003C/p\u003E",
"datetime": 1590962400,
"link": "https://www.wankendorfer.de/news-detail/die-neue-gustav-boehm-siedlung/",
"image": {
"uid": 16,
"tstamp": 1631781850,
"name": "1600x600.png",
"sha1": "8bc14435dd8b9802d8cd255b898ce506a36e6c6d",
"title": "TestTitle",
"description": "Eine Test-Description",
"alternative": "Test Image",
"source": "https://www.wankendorfer.de/fileadmin/testfiles/1600x600.png"
},
"categories": [
4,
1
],
"contactPersons": []
},
{
"uid": 5,
"title": "Freunde finden leicht gemacht",
"teaser": "Endlich wieder unbeschwert die Gemeinschaft genie\u00dfen. Was \u00fcber ein Jahr lang wohl einer der gr\u00f6\u00dften W\u00fcnsche von Kindern war, wurde jetzt wieder erm\u00f6glicht. ",
"bodytext": "\u003Cp\u003EDank einer tollen Organisation des \u003Cstrong\u003EFerienhofs am Klint\u003C/strong\u003E und der neuen Leiterin Nicole Lubbe konnten vom 03.07. bis zum 11.07. wieder 17 Kinder zwischen 9 und 13 Jahren ins Camp eingeladen werden. Zwar unter etwas strengeren Hygieneauflagen, aber dennoch mit ganz viel Freiheit f\u00fcr Spiel, Spa\u00df, Kreativit\u00e4t und gute Laune.\u003C/p\u003E\r\n\u003Cp\u003EZiel des Camps war es auch in diesem Jahr wieder, den Kindern eine unbeschwerte Zeit zu bieten \u0026shy;\u2013 ohne Handy, Computer oder andere Ablenkungen. So waren die Gemeinschaft und das Miteinander die wichtigsten Punkte des Camps, das 2021 unter dem \u003Cstrong\u003EMotto M\u00e4rchen\u003C/strong\u003E stand. Da wurde der Froschk\u00f6nig gespielt und mit vielen Geschichten in die Welten von Fabelwesen und Prinzessinnen eingetaucht.\u003C/p\u003E\r\n\u003Cp\u003EUntergebracht waren die Kinder in einem gro\u00dfen Zirkuszelt unter Aufsicht eines erfahrenen P\u00e4dagogenteams. Das Besondere in diesem Jahr: Zwei Jugendliche, die in den letzten Jahren selber am Camp teilgenommen hatten, wurden mit ins Betreuerteam aufgenommen. \u201eDies ist der beste Beweis daf\u00fcr, wie nachhaltig und verbindend unsere Camps auch bei den Kindern wirken\u201c, so Dr. Ulrik Schlenz, Vorstandsmitglied der wankendorfer.\u003C/p\u003E\r\n\u003Cp\u003EFreundschaften wurden gekn\u00fcpft, viele B\u00e4lle \u00fcber die Wiesen getreten und gemeinsam ging es dann auch noch in den Tierpark Eekholt. Die Eltern der Kinder zahlten auch in diesem Jahr nur einen Anteil von 100 \u20ac pro Kind, den Rest \u00fcbernahm vollst\u00e4ndig die Wankendorfer Baugenossenschaft.\u003C/p\u003E\r\n\u003Cp\u003EZu Beginn des Camps bekam jedes Kind von der wankendorfer zudem eine Cap sowie ein T-Shirt und einen Schlafsack mit seinem Namen drauf. Diese konnten die Kinder w\u00e4hrend der Woche nutzen und am Ende als weitere sch\u00f6ne Erinnerung mit nach Hause nehmen. Denn gerade Erinnerungen sind ungemein wichtig f\u00fcr Kinder. Vor allem, wenn sie so spannend sind wie bei den Teilnehmern des diesj\u00e4hrigen Camps.\u003C/p\u003E",
"datetime": 1626087900,
"link": "https://www.wankendorfer.de/news-detail/freunde-finden-leicht-gemacht/",
"image": [],
"categories": [
5,
6,
1
],
"contactPersons": [
121
]
}
],
"categories": [
{
"uid": 5,
"title": "In eigener Sache"
},
{
"uid": 6,
"title": "Verantwortung"
},
{
"uid": 1,
"title": "F\u00fcr Mieter"
},
{
"uid": 4,
"title": "Bauprojekte"
}
],
"contactPersons": [
{
"uid": 121,
"firstName": "Ulrik",
"lastName": "Schlenz",
"academicTitle": "Dr.",
"jobTitle": "",
"jobFunction": "",
"email": "u.schlenz@wankendorfer.de",
"phone": "0431 2005-201",
"mobile": "",
"image": [],
"department": "Vorstand"
},
{
"uid": 403,
"firstName": "Susanne",
"lastName": "B\u00f6ckmann",
"academicTitle": "",
"jobTitle": "",
"jobFunction": "Mieterbetreuer",
"email": "s.boeckmann@wankendorfer.de",
"phone": "0431 2005-289",
"mobile": "",
"image": [],
"department": "Vermietung und Wohnservice"
}
]
}
Felder
Im Folgenden werden die Felder der unterschiedlichen Datensatztypen beschrieben:
Felder eines News-Datensatzes:
Feldname | Feldtyp | Beschreibung | Beispiel |
---|---|---|---|
uid | Integer | ID des News-Datensatzes | 3 |
title | String | Titel des Datensatzes | Das Stadtbüro in Bad Segeberg zieht um! |
teaser | String | Kurzer Teaser-Text | Ab dem 3. Februar in der Kurhausstraße 14 im 3. Obergeschoss |
bodytext | String | Beschreibungstext der Nachricht | <p>Anfang Februar wird das Stadtbüro der wankendorfer aus der <strong>Oldesloer Straße 11-13</strong> in neue Räume umziehen. </p> |
datetime | Integer | Datum und Zeit der Nachricht als Unix-Timestamp | 1582632300 |
link | String | URL zur Detailseite der Nachricht | www.wankendorfer.de/news-detail/das-stadtbuero-in-bad-segeberg-zieht-um/ |
image | Array | Zugehöriges Bild der Nachricht | siehe Abschnitt "Felder eines Bildes" |
categories | Array<Integer> | Verknüpfte Kategorien der Nachricht | [5,6,1] |
contactPersons | Array<Integer> | Verknüpfte Ansprechpartner der Nachricht | [7,8,4] |
Felder eines Bildes:
Feldname | Feldtyp | Beschreibung | Beispiel |
---|---|---|---|
uid | Integer | ID des Bildes | 123 |
tstamp | Integer | Datum und Zeit der letzten Bearbeitung des Bild-Datensatzes | 1582632300 |
name | String | Name des Bildes (entweder der Dateiname des Bildes oder ein Text, der diesen überschreibt) | 1600x600.png |
sha1 | String | SHA1-Hash des Bildes | 8bc14435dd8b9802d8cd255b898ce506a36e6c6d |
title | String | Titel des Bildes | Test-Titel |
description | String|null | Beschreibung des Bildes | Lorem ipsum dolor sit amet. |
alternative | String|null | Textliche Alternative für das Bild | Das Bild zeigt ein großes Haus. |
source | String | Pfad zum Bild |
Felder einer Kategorie:
Feldname | Feldtyp | Beschreibung | Beispiel |
---|---|---|---|
uid | Integer | ID der Kategorie | 456 |
title | String | Titel der Kategorie | Bauprojekte |
Felder eines Ansprechpartners:
Feldname | Feldtyp | Beschreibung | Beispiel |
---|---|---|---|
uid | Integer | ID des Ansprechpartner-Datensatzes | 789 |
firstName | String | Vorname des Ansprechpartners | Max |
lastName | String | Nachname des Ansprechpartners | Mustermann |
academicTitle | String | Akademischer Titel des Ansprechpartners | Prof. Dr. |
jobTitle | String | Job-Titel des Ansprechpartners | Hausmeister |
jobFunction | String | Job-Funktion des Ansprechpartners | Teamleiter |
String | E-Mail-Adresses des Ansprechpartners | mustermann@wankendorfer.de | |
phone | String | Telefonnummer des Ansprechpartners | 01234 1234567-89 |
mobile | String | Mobilfunknummer des Ansprechpartners | 0171 1234567-89 |
image | Array | Zugehöriges Bild des Ansprechpartners | siehe Abschnitt "Felder eines Bildes" |
department | String | Abteilung des Ansprechpartners | Rechnungswesen |
Filter für News-Datensätze
Über folgende Kriterien kann die Ausgabe der News-Datensätze eingeschränkt werden:
- Kategorien
- Zeit
Filter-Parameter
Folgende Parameter können zur Einschränkung des Ausgabe-Ergebnisses übergeben werden:
Feldname | Feldtyp | Beschreibung | Beispiel |
---|---|---|---|
categories | Array<Integer> | Eine Liste mit numerischen IDs der gewünschten Kategorien | 5,1 |
categoryConjunction | String | and = Nur News-Datensätze, die mit allen übergebenen Kategorien verknüpft sind, werden ausgegeben or = News-Datensätze, die einer der übergebenen Kategorie-IDs zugehörig sind, werden ausgegeben (Standard-Wert: "and") | or |
timeRestrictionGreater | Integer | Alle News-Datensätze, deren Datum nach dem übergebenen Unix-Timestamp liegen, werden geliefert | 1600000000 |
timeRestrictionLess | Integer | Alle News-Datensätze, die älter als der übergebene Unix-Timestamp sind, werden geliefert | 1620000000 |
Die Parameter werden als GET-Request als Felder innerhalb eines Arrays "filter" übergeben. Alle Parameter sind optional und können beliebig kombiniert werden.
Beispiel-Aufrufe
- Alle News:
https://www.wankendorfer.de/jsonapi/v1/news/ - Nur News-Datensätze, die mit der Kategorie uid = 5 verknüpft sind:
https://www.wankendorfer.de/jsonapi/v1/news/?filter[categories]=5 - News-Datensätze, die entweder mit der Kategorie uid = 5 oder uid = 1verknüpft sind:
https://www.wankendorfer.de/jsonapi/v1/news/?filter[categories]=5,1&filter[categoryConjunction]=or - News-Datensätze, die sowohl mit der Kategorie uid = 5 und uid = 1verknüpft sind:
https://www.wankendorfer.de/jsonapi/v1/news/?filter[categories]=5,1&filter[categoryConjunction]=and - Zeiteinschränkung:
https://www.wankendorfer.de/jsonapi/v1/news/?filter[timeRestrictionGreater]%20=1600000000&filter[timeRestrictionLess]=1620000000 - Alle Filter kombiniert:
https://www.wankendorfer.de/jsonapi/v1/news/?filter[categories]=5,1&filter[categoryConjunction]=and&filter[timeRestrictionGreater]=1600000000&filter[timeRestrictionLess]=1620000000
Stand: 19. Oktober 2021