API-Version 1.1

Diese Dokumentation erklärt, wie Sie Ihre Anwendung registrieren, konfigurieren und entwickeln, damit Sie unsere APIs erfolgreich nutzen können

Anwendung erstellen

Damit Ihre Anwendung auf unsere APIs zugreifen kann, müssen Sie Ihre Anwendung mit der Anwendung Dashboard. Bei der Registrierung wird eine App-ID erstellt, mit der wir wissen, wer Sie sind, und die uns hilft, Ihre App von anderen Apps zu unterscheiden.

1. Dazu müssen Sie eine neue App erstellen Neue Anwendung erstellen
2. Sobald Sie Ihre App erstellt haben, erhalten Sie Ihre app_id und app_secret

Einloggen mit

Das Log-in With-System ist eine schnelle und bequeme Möglichkeit für Personen, Konten zu erstellen und sich bei Ihrer App anzumelden. Unser Log in With-System ermöglicht zwei Szenarien: Authentifizierung und die Beantragung von Berechtigungen für den Zugriff auf die Daten von Personen. Sie können das Login With-System einfach für die Authentifizierung oder sowohl für die Authentifizierung als auch für den Datenzugriff verwenden.

1. Um den OAuth-Anmeldeprozess zu starten, müssen Sie einen Link für Ihre Anwendung wie folgt verwenden:

   <a href="https://halloj.de/api/oauth?app_id=YOUR_APP_ID">Log in With halloj.de – Dein soziales Netzwerk für echte Verbindungen</a>

   Der Benutzer wird zur Seite Anmelden mit wie folgt umgeleitet

   
2. Sobald der Benutzer Ihre App akzeptiert hat, wird er zu Ihrer App-Redirect-URL weitergeleitet mit auth_key wie diese:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   Diese auth_key gilt nur für die einmalige Verwendung, d. h., wenn Sie ihn einmal benutzt haben, können Sie ihn nicht erneut verwenden und einen neuen Code generieren, sondern müssen den Benutzer erneut auf den Link „Anmelden mit“ umleiten.

Zugangstoken

Sobald Sie die Zustimmung des Benutzers zu Ihrer Anwendung erhalten haben, melden Sie sich mit dem Fenster an und kehren mit dem auth_key das bedeutet, dass Sie jetzt bereit sind, Daten von unseren APIs abzurufen. Um diesen Prozess zu starten, müssen Sie Ihre Anwendung autorisieren und die access_token und Sie können unsere Schritte befolgen, um zu lernen, wie man es bekommt.

1. Um ein Zugriffstoken abzurufen, stellen Sie eine HTTP-GET-Anfrage an den folgenden Endpunkt wie folgt:

   <?php
   $app_id = "YOUR_APP_ID"; // your app id
   $app_secret = "YOUR_APP_SECRET"; // your app secret
   $auth_key = $_GET['auth_key']; // the returned auth key from previous step
   
   $get = file_get_contents("https://halloj.de/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
   
   $json = json_decode($get, true);
   if(!empty($json['access_token'])) {
       $access_token = $json['access_token']; // your access token
   }
   ?>

   Diese access_token nur für 1 Stunde gültig, d.h. wenn sie ungültig geworden ist, müssen Sie eine neue generieren, indem Sie den Benutzer wieder auf den Login-Link umleiten.

APIs

Sobald Sie Ihre access_token Jetzt können Sie Informationen aus unserem System über HTTP GET-Anfragen abrufen, die folgende Parameter unterstützen

Sie können die Benutzerdaten wie folgt abrufen

if(!empty($json['access_token'])) {
   $access_token = $json['access_token']; // your access token
   $get = file_get_contents("https://halloj.de/api/get_user_info?access_token=$access_token");
}

Das Ergebnis lautet:

{
    "user_info": {
        "user_id": "",
        "user_name": "",
        "user_email": "",
        "user_firstname": "",
        "user_lastname": "",
        "user_gender": "",
        "user_birthdate": "",
        "user_picture": "",
        "user_cover": "",
        "user_registered": "",
        "user_verified": "",
        "user_relationship": "",
        "user_biography": "",
        "user_website": ""
    }
}