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.1Cré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
Vous devez d’abord créer une application Créer une application
-
2
Une fois votre application créée, vous obtiendrez votre
app_idetapp_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
Pour lancer le processus de connexion OAuth, utilisez un lien vers votre application comme celui-ci:
L’utilisateur sera redirigé vers une page Se connecter avec comme celle-ciHTML
<a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
-
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_keycomme ceci:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYCeauth_keyn’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.
<?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
}
?>
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
/api/get_user_info
obtenir les informations de l’utilisateur
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");
}
{
"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": ""
}
}