API

Übersicht

Um zukünftigen regionalen Anwendungen wie z. B. Veranstaltungskalender eine einheitliche Datenbasis zu bieten, können in nerdhood.de gespeicherte und öffentlich verfügbare Daten direkt gesucht und referenziert werden. Im Moment findet weder ein Rate-Limiting statt, noch wird ein dedizierter API-Key benötigt.

Points of Interest (POI)

Points of Interest können Unternehmensstandorte oder auch spezielle Lokationen für Veranstaltungen sein.

Suche nach POIs

GET https://api.nerdhood.de/poi?q=${name-des-unternehmens}

POI referenzieren

GET https://api.nerdhood.de/poi/${poi-uuid} # oder GET https://poi.nerdhood.de/${poi-uuid}

Weitergabe des POIs in RSS-Feeds

Um die einfache Weitergabe des POIs innerhalb eines RSS-Feeds zu ermöglichen, kann dies über einen eigenen Namespace erfolgen:

                <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"
                     xmlns:poi="http://things.nerdhood.de/ns/poi">
                <channel>
                    <item>
                    ...
                        <poi:uuid>${poiUuid}</poi:uuid>
                    </item>
                </channel>
                </rss>