Babafig đŸ‡·đŸ‡Ș
Se connecter S’inscrire

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.babafig.com/api/oauth?app_id=YOUR_APP_ID">Log in With Babafig đŸ‡·đŸ‡Ș</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.babafig.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.babafig.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": ""
  }
}