Zum Hauptinhalt springen

JASN-Doku für BiK-API-Schnittstelle

 Die API funktioniert im  JASN-Format. Die detaillierte Doku haben wir hier als Beispiel hinterlegt.

Sie ist im Stand vom 29.08.2024

 Die Schnittstelle wird erreicht über folgenden Link: 

https://be.bildung-kirchen.de/api/Veranstaltungen/update

Sie kann getestet werden über folgenden Link: 

https://lag-backend.gfedev2021.gfeserver.de/api/Veranstaltungen/update

 Es muss eine POST-Anfrage sein und den Header AUTHORIZATION mit dem Veranstalter-API-Schlüssel enthalten.
Die Daten müssen im JASN-Format vorliegen, so wie hier im Beispiel: 

[

 {

  "key": "testveranstaltung",

  "name": "testveranstaltung",

  "beschreibungKurz": "Dies ist die Kurzbeschreibung",

  "beschreibungLang": "Dies ist die ausführliche Beschreibung der Veranstaltung",

  "latitude": "48.778449",

  "longitude": "9.180013",

  "ortname": "Entenhausen",

  "anfahrtsbeschreibung": "Von Entenburg kommend stets rechts halten und nach dem Geldspeicher links abbiegen.",

  "beginn": 1654177936,

  "ende": 1654187936,

  "ics": "BEGIN:VCALENDAR VERSION:2.0 PRODID:-////DE METHOD:PUBLISH BEGIN:VEVENT UID:2321dfdc-6c58-4a74-a6ed-1fe5b318466f DTSTAMP:20220509T063905Z LOCATION:Kanzleigasse 30, 78050 Villingen-Schwenningen SUMMARY:Einführung in Zoom DESCRIPTION:<p>An Online-meetings teilnehmen oder sie evtl. sogar selber planen und andere dazu einladen können, ist eine wichtige Kompetenz geworden um teilhaben zu können an ganz verschiedenen Angeboten. Sei es der Rückengymnastikkurs oder einen Vortrag online hören. Hier lernen Sie was es dazu braucht: </p>, <ol><li>Welche technischen Voraussetzung sind nötig</li><li>Wie kann ich die Oberläche von Zoom nutzen</li><li>Wie kann ich die Anderen sehen und hören</li><li>Wie kann ich mich zu Wort melden usw.</li></ol>, <p><br>Dies ist ein Angebot des Bildungszentrum Villingen (Erzdiözese Freiburg) im Rahmen von KiLAG digital </p>, <figure style=\",width: 195px; max-width: 195px;\",><img class=\",redactor-autoparser- object\", src=\",https://storage.amosweb.de/storage/anbieter/1172/mandanten/2217/event/ descriptionTextFiles/IXnNvBspAk0rE3li8r2kaqBtyDbVsaZkRtGNa5rb.jpg\", data-mage=\",qoipk18d56rn\", width=\",195\", height=\",149\", style=\",width: 195px; max-width: 195px; height: 149px;\",></figure> DTSTART;VALUE=DATE:20220621 DTEND;VALUE=DATE:20220622 END:VEVENT END:VCALENDAR",

  "mindestalter": 14,

  "hoechstalter": 99,

  "leistungen": "Frühstücksbuffet und Kurshandbuch",

  "teilnahmebedingungen": "Lust an der Freude",

  "bilder": [

    {"url": "https://www.gfe-media.de/fileadmin/user_upload/slides/bg_kontakt_zu_uns.jpg",

     "fileName": "bg_kontakt_zu_uns.jpg"

    },

    {

     "url":

"https://www.gfe-media.de/blog/wp-content/uploads/2020/06/GFE_Blog_Mehrwertsteuersenkung_20200615.jpg",

     "fileName": "GFE_Blog_Mehrwertsteuersenkung_20200615.jpg"

    }

    ],

    "categories": [

     "Fort- und Weiterbildung",

     "Länder, Kulturen"

    ],

    "konfession" : "Evangelisch",

    "barrierearm" : true,

    "zielgruppen": [

     "Veranstaltungen und Weiterbildung für Erwachsene",

     "Fort- und Weiterbildungsangebote der Hochschulen "

    ],

    "veranstaltungsreihe": true,

    "link": "https://gfe-media.de/anmeldung/testveranstaltung"

   },

   {

    "key": "testveranstaltung2",

    "name": "testveranstaltung2",

    "beschreibungKurz": "Dies ist die Kurzbeschreibung 2",

    "beschreibungLang": "Dies ist die ausführliche Beschreibung der Veranstaltung2 ",

    "online": true,

    "latitude": "48.778449",

    "longitude": "9.180013",

    "ortname": "Entenhausen",

    "beginn": 1654177936,

    "ende": 1654187936,

    "veranstaltungsreihe": false,

    "anzeigen": true,

    "maximaleAnzahlTeilnehmer": 35,

    "freiePlaetze": 35,

    "referent": "Hans Heinrich,Experte im Bereich XX,blablabla",

    "veranstaltungsformat": "Seminar|Lesung|someMore",

    "preis": 300,

    "gefoerdert": true,

    "bilder": [

     {

      "url": "https://www.gfe-media.de/fileadmin/user_upload/slides/bg_kontakt_zu_uns.jpg",

       "fileName": "bg_kontakt_zu_uns.jpg"

     },

     {

      "url":

      "https://www.gfe-media.de/blog/wp-content/uploads/2020/06/GFE_Blog_Mehrwertsteuersenkung_20200615.jpg",

      "fileName": "GFE_Blog_Mehrwertsteuersenkung_20200615.jpg"}

     ],

     "Web-Based-Training" : true,

     "link": "https://gfe-media.de/anmeldung/testveranstaltung2"

    }

   ]


 Hier ist die Beschreibung noch als PDF-Download hinterlegt. 

Verfasst von:
Oliver Streppel
Oliver Streppel

Was bewegt mich dazu als Autor in diesem Blog etwas zu veröffentlichen? Mich treibt eine Frage immerzu an: Wie mache ich Bildung interessanter. Als studierter Medienpädagoge, gelernter Film- und Mediendesigner, zertifizierter Blended-Learning-Designer, Autor, Bildungsreferent bei der Evangelischen Erwachsenen- und Familienbildung, als Vater von Vier Kindern und Hörspielfan habe ich ein breites Spektrum an Interessen und Hintergrundwissen, das ich immer wieder gerne dafür einsetze dieser Frage nachzugehen. Falls Du über eine Frage stolperst, die wir gerne gemeinsam auf den Grund gehen wollen, dann nur gerne her damit.