Authentication

Registrieren Sie sich hier und greifen mit Ihrem Api key auf alle News und Termine aus dem Redaktionsnetzwerk der Hessen Agentur zu.

Es gibt einen freien Zugang, mit dem Sie auf alle Inhalte zugreifen können. Die einzige Einschränkung besteht darin, dass die Texte nur angeteasert sind und der Link zur Vollansicht auf das entsprechende Portal in den Detailartikel verlinkt.

Den ApiKey können Sie mit folgenden Methoden verwenden:

  • Via ApiKey querystring Parameter
  • Via ApiKey HTTP header nicht base64 encoded

Wir empfehlen den Einsatz per HTTP Header, damit ist der ApiKey nicht für andere sichtbar und taucht auch nicht in Logdateien auf.

Der ApiKey setzt eine valide E-Mailadresse vorraus. Wird der ApiKey nicht richtig benutzt, wird ein 401-Unauthorized HTTP Fehler generiert.

Codebeispiel Coldfusion

<cfhttp result="x" url="https://opendata.hessen-agentur.de/api/artikel?type=termin&sources=HEA">
<cfhttpparam type="header" value="XYZ" name="ApiKey">
</cfhttp>

<cfset news = deserializeJSON(x.Filecontent)>

Codebeispiel Redaxo

$data = null;
    $endPointUrl= 'https://opendata.hessen-agentur.de/api/artikel?Type=news';
    $ApiKey='XYZ';
    try {
        $socket = \rex_socket::factoryUrl($endPointUrl);
        $socket->addHeader('ApiKey', $ApiKey);
        $response = $socket->doGet();

        if ($response->isOk()) {
            $data = json_decode($response->getBody(), true);
            if (json_last_error() !== JSON_ERROR_NONE || !is_array($data) || !isset($data['TotalResults'])) {
                $data = null;
                throw new \rex_socket_exception(sprintf('Response body von %s fehlerhaft', $endPoint));
            }

            \rex_extension::registerPoint(new \rex_extension_point('OPEN_DATA_FETCHED', null, [
            'endPoint' => $endPoint,
            'data' => $data[$arrayKey],
            ]));
        }
    } catch (\rex_socket_exception $e) {
        dump($e);
    }
    dump($data);

ApiKey erhalten

Hier schicken wir den Api key hin.