Entwickler | Linkheed

API Version 1.1

Diese Dokumentation erklärt, wie du deine Anwendung registrierst, konfigurierst und entwickelst, damit du unsere APIs erfolgreich nutzen kannst.

App erstellen

Damit deine Anwendung auf unsere APIs zugreifen kann, musst du deine Anwendung mit der App Dashboard. Bei der Registrierung wird eine App-ID erstellt, mit der wir wissen, wer du bist und die uns hilft, deine App von anderen Apps zu unterscheiden..

Du musst eine neue App erstellen Neue App erstellen
Sobald du deine App erstellt hast, erhältst du app_id und app_secret

Anmelden mit

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

Um den OAuth-Anmeldeprozess zu starten, musst du einen Link für deine Anwendung wie folgt verwenden:
```
<a href="https://linkheed.com/api/oauth?app_id=YOUR_APP_ID">Log in With Linkheed</a>
```
Der Benutzer wird zur Seite Anmelden mit wie folgt umgeleitet
Sobald der Benutzer deine App akzeptiert hat, wird er zu deiner 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 du ihn einmal benutzt hast, kannst du ihn nicht erneut verwenden und einen neuen Code generieren, sondern musst den Benutzer erneut auf den Link „Anmelden mit“ umleiten.

Access Token

Once you get the user approval of your app Log in With window and returned with the auth_key Das bedeutet, dass du jetzt bereit bist, Daten von unseren APIs abzurufen. Um diesen Prozess zu starten, musst du deine Anwendung autorisieren und die access_token und du kannst unsere Schritte befolgen, um zu lernen, wie man es bekommt.

Um ein Zugriffstoken abzurufen, stelle 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://linkheed.com/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, musst du eine neue generieren, indem du den Benutzer wieder auf den Login-Link umleitest.

APIs

Sobald du deine access_token Jetzt kannst du Informationen aus unserem System über HTTP GET-Anfragen abrufen, die folgende Parameter unterstützen

Endpunkt	Beschreibung
api/get_user_info	Benutzerinformationen abrufen

Du kannst die Benutzerinformationen wie folgt abrufen

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

Das Ergebnis wird sein:

                                                {
                                                  "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": ""
                                                  }
                                                }