Entwickler

Entdecke unsere Entwickler-Tools

Diese Dokumentation erklärt, wie du deine App registrierst, konfigurierst und entwickelst, um unsere APIs erfolgreich zu nutzen

API-Version 1.1

App erstellen

Damit deine App auf unsere APIs zugreifen kann, musst du sie registrieren, und zwar über das App-Dashboard. Bei der Registrierung wird eine App-ID erstellt, anhand derer wir wissen, wer du bist, und deine App von anderen Apps unterscheiden können.

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

Anmelden mit

„Anmelden mit“ ist eine schnelle und bequeme Möglichkeit für Personen, Konten zu erstellen und sich bei deiner App anzumelden. „Anmelden mit“ ermöglicht zwei Szenarien: die Authentifizierung und das Anfragen von Berechtigungen für den Zugriff auf Personendaten. Du kannst „Anmelden mit“ nur zur Authentifizierung oder zur Authentifizierung und für den Datenzugriff verwenden.

  1. 1 Um den OAuth-Anmeldeprozess zu starten, verwende für deine App einen Link wie diesen:
    HTML
    <a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
    Der Benutzer wird dann zu einer „Anmelden mit“-Seite wie dieser weitergeleitet
  2. 2 Sobald der Benutzer deine App akzeptiert hat, wird er zu deiner App-Redirect-URL weitergeleitet, zusammen mit auth_key zum Beispiel so:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Dieser auth_key ist nur einmal gültig. Nach der Verwendung kannst du ihn nicht erneut nutzen. Für einen neuen Code musst du den Benutzer erneut zum „Anmelden mit“-Link weiterleiten.

Zugriffstoken

Sobald der Benutzer deine App im „Anmelden mit“-Fenster genehmigt hat und du mit dem auth_key zurückgeleitet wurdest, kannst du Daten von unseren APIs abrufen. Dazu musst du zuerst deine App autorisieren und das access_token abrufen. Wie das geht, erfährst du in den folgenden Schritten.

Um ein Zugriffstoken abzurufen, sende eine HTTP-GET-Anfrage an den folgenden Endpunkt, zum Beispiel so:
PHP
<?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

// Prepare the POST data
$postData = [
  'app_id' => $app_id,
  'app_secret' => $app_secret,
  'auth_key' => $auth_key
];

// Initialize cURL
$ch = curl_init('https://www.flexartsocial.com/api/authorize');

// Set cURL options for POST
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));

// Execute request
$response = curl_exec($ch);

// Check for cURL errors
if (curl_errno($ch)) {
  die('cURL error: ' . curl_error($ch));
}

// Decode the JSON response
$json = json_decode($response, true);

// Use the access token if available
if (!empty($json['access_token'])) {
  $access_token = $json['access_token']; // your access token
}
?>
Dieser access_token ist nur 1 Stunde gültig. Danach musst du ein neues erstellen, indem du den Benutzer erneut zum „Anmelden mit“-Link weiterleitest.

APIs

Sobald du dein access_token hast, kannst du über HTTP-GET-Anfragen Informationen aus unserem System abrufen. Folgende Parameter werden unterstützt

GET /api/get_user_info Benutzerinformationen abrufen
So kannst du Benutzerinformationen abrufen
PHP
if (!empty($json['access_token'])) {
  $access_token = $json['access_token']; // your access token
  $get = file_get_contents("https://www.flexartsocial.com/api/get_user_info?access_token=$access_token");
}
Das Ergebnis sieht so aus:
JSON
{
  "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": ""
  }
}