Basisdaten-API

Die Basisdaten-API ist ein jüngerer Ableger der Eintrags-API. Über diese werden immer alle vohandenen aktiven Einträge eines Portals zurückgegeben. Daten können über die API nicht verändert werden, es ist also eine Schnittstelle nur zum Lesen von Daten.

Aktivierung der API

Die API kann jederzeit durch den Support aktiviert werden. WICHTIG: Diese API sollte nicht zusammen mit Mehrsprachigkeit aktiviert werden, da derzeit die abgerufenen Eintragsdaten nicht einheitlich in einer Sprache zurückgegeben werden.

Unter Einstellungen > Api Einstellungen wird dann ein automatisch generierter API-Key angezeigt, den man als Portalbetreiber dem Nutzer der API mitteilen kann. Dieser kann jederzeit auch verändert werden, z. B. bei Missbrauch. Nach Änderung ist ab sofort nur noch der neue Key gültig.

Auf Wunsch kann diese API natürlich auch jederzeit wieder deaktiviert werden. Temporär kann man auch einfach einen neun Token vergeben, um Zugriffe auf die API sofort zu unterbinden.

Nutzung der API

Die Api hat ihren Endpunkt auf dem jeweiligen Portal unter „/basic-entries/v1“. Um auf die API zuzugreifen, muss ein Get-Request mit einem X-Auth-Token im Header des Aufrufs abgesetzt werden, der Value ist der Token, den der Portalbetreiber festlegen kann bzw. der beim Aktivieren der API automatisch erstellt wurde.

Aufbau der Daten

Die API gibt alle veröffentlichten Einträge auf dem Portal zurück im Json-Format. Auf der obersten Ebene handelt es sich um ein Array, das Einträge enthält. Diese bestehen aus Basisdaten wie der ID eines Eintrags und Erstell- und Änderungsdatum. Außerdem enthält jeder Eintrag eine Liste mit befüllten Eigenschaften.

Der Name einer Eigenschaft wird normalerweise nur beim Anlegen einer Eigenschaft angelegt und bleibt für immer unverändert. Der DisplayText, also der Anzeigetext dieser Eigenschaft kann sich jedoch ändern.

Das Format der Eigenschaftstypen (also das jeweilige Value-Feld) ist identisch mit dem der Eintrags-API und es wird dort auf der Seite Eintragstypen beschrieben.

Die Liste der Einträge wird jede Nacht aktualisiert, d.h. die Daten über die API sind immer nur tagesaktuell. Diese können also in Einzelfällen von den aktuellen Daten im Portal abweichen, wenn diese am gleichen Tag bereits geändert worden sind. Es können hier auch noch Einträge zurückgeben werden, die evtl. bereits deaktiviert sind bzw. Einträge fehlen, die erst am gleichen Tag angelegt oder aktiviert worden sind.

[
    {
        "EntryId":150463,
        "ModifiedDate":"2023-11-21T14:05:54",
        "CreatedDate":"2023-10-18T15:59:02",
        "Url":"http://discoverize/yoga/bozena-anna-bartnik",
        "NumberOfRatings":1,
        "AverageRating":5.0,
        "Properties":
        [
            {
                "Name":"Name",
                "DisplayText":"Name des Eintrags",
                "Type":"Text",
                "Value":"Bozena Anna Bartnik"
            }, 
            {
                "Name":"Street",
                "DisplayText":"Straße mit Hausnummer",
                "Type":"Text",
                "Value":"Beurhausstraße 53"
            }
        ]
    }
]

    Unverbindlichen Beratung anfragen

    Gerne besprechen wir in einem Vorgespräch in ca. 15 Minuten Ihre Portalidee und ob und wie sich diese mit discoverize umsetzen ließe. Entweder per Telefon oder gerne auch in Person bei uns im Büro.



    9-12 Uhr12-15 Uhr15-18 Uhr

      Kontakt zum discoverize Team

      Bei allen Fragen rund Branchenportale, Beratung, Strategie helfen wir gerne weiter.