Version API 1.1

Cette documentation explique comment enregistrer, configurer et développer votre application pour que vous puissiez utiliser nos API avec succès

Créer une application

Pour que votre application puisse accéder à nos API, vous devez enregistrer votre application en utilisant le App Dashboard. L'enregistrement crée un identifiant d'application qui nous permet de savoir qui vous êtes, et nous aide à distinguer votre application des autres applications.

1. Vous devrez créer une nouvelle application Créer une nouvelle application
2. Une fois que vous avez créé votre application, vous obtiendrez votre app_id et app_secret

Déconnexion

Le système Log in With est un moyen rapide et pratique pour les personnes de créer des comptes et de se connecter à votre application. Notre système "Log in With" permet deux scénarios, l'authentification et la demande d'autorisations pour accéder aux données des personnes. Vous pouvez utiliser le système Login With simplement pour l'authentification ou à la fois pour l'authentification et l'accès aux données.

1. Pour démarrer le processus de connexion à OAuth, vous devez utiliser un lien pour votre application comme ceci:

   <a href="https://www.babafig.com/api/oauth?app_id=YOUR_APP_ID">Log in With Babafig 🌍</a>

   L'utilisateur sera redirigé vers la page "Log in With" comme suit

   
2. Une fois que l'utilisateur a accédé à votre application, il sera redirigé vers votre URL de redirection avec auth_key aime ça:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   Ce auth_key valable pour une seule utilisation, donc une fois que vous l'avez utilisé, vous ne pourrez plus l'utiliser à nouveau et générer un nouveau code ; vous devrez rediriger l'utilisateur vers la connexion avec lien à nouveau.

Jeton d’accès

Une fois que vous avez obtenu l'approbation de l'utilisateur de votre application, connectez-vous avec la fenêtre Log in With et revenez avec le auth_key ce qui signifie que vous êtes maintenant prêt à récupérer les données de nos API et que pour lancer ce processus, vous devrez autoriser votre application et obtenir le access_token et vous pouvez suivre nos étapes pour apprendre comment l'obtenir.

1. Pour obtenir un jeton d'accès, faites une demande HTTP GET sur le terminal suivant comme ceci:

   <?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));
   }
   
   curl_close($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 valide seulement pour une heure, donc une fois qu'il est devenu invalide, vous devrez en créer un nouveau en redirigeant l'utilisateur vers le lien de connexion à nouveau.

APIs

Une fois que vous avez obtenu votre access_token Vous pouvez désormais récupérer des informations dans notre système via des requêtes HTTP GET qui prennent en charge les paramètres suivants

Vous pouvez récupérer les informations sur l'utilisateur comme suit

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:

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