Développeurs

Explorez les outils pour développeurs que nous proposons

Cette documentation explique comment enregistrer, configurer et développer votre application pour utiliser nos API

Version de l’API 1.1

Créer une application

Pour que votre application puisse accéder à nos API, vous devez l’enregistrer depuis le tableau de bord des applications. L’enregistrement crée un ID d’application qui nous permet de savoir qui vous êtes et de distinguer votre application des autres.

  1. 1
    Vous devez d’abord créer une application Créer une application
  2. 2
    Une fois votre application créée, vous obtiendrez votre app_id et app_secret

Se connecter avec

Le système Se connecter avec permet aux utilisateurs de créer un compte et de se connecter à votre application de manière simple et rapide. Il couvre deux cas d’usage : l’authentification et la demande d’autorisation d’accès aux données des utilisateurs. Vous pouvez l’utiliser uniquement pour l’authentification, ou à la fois pour l’authentification et l’accès aux données.

  1. 1 Pour lancer le processus de connexion OAuth, utilisez un lien vers votre application comme celui-ci:
    HTML
    <a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
    L’utilisateur sera redirigé vers une page Se connecter avec comme celle-ci
  2. 2 Une fois que l’utilisateur a accepté votre application, il est redirigé vers l’URL de redirection de votre application avec le paramètre auth_key comme ceci:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Ce auth_key n’est valable qu’une seule fois. Une fois utilisé, vous ne pourrez plus le réutiliser. Pour obtenir un nouveau code, vous devrez rediriger l’utilisateur vers le lien Se connecter avec.

Jeton d’accès

Une fois que l’utilisateur a approuvé votre application dans la fenêtre Se connecter avec, vous recevez le paramètre auth_key et vous êtes prêt à récupérer des données depuis nos API. Pour commencer, vous devez autoriser votre application et obtenir le jeton access_token en suivant les étapes ci-dessous.

Pour obtenir un jeton d’accès, envoyez une requête HTTP GET au point de terminaison suivant, comme ceci:
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
}
?>
Ce access_token n’est valable qu’une heure. Une fois expiré, vous devrez en générer un nouveau en redirigeant l’utilisateur vers le lien Se connecter avec.

API

Une fois votre access_token obtenu, vous pouvez récupérer des informations de notre système via des requêtes HTTP GET, qui acceptent les paramètres suivants

GET /api/get_user_info obtenir les informations de l’utilisateur
Vous pouvez récupérer les informations de l’utilisateur comme ceci
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");
}
Le résultat sera:
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": ""
  }
}