Version de l'API 1.1

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

Créer une application

Pour que votre application accède à nos API, vous devez enregistrer votre application à l'aide du Tableau de bord d'application. L'inscription crée un ID d'application qui nous permet de savoir qui vous êtes, 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
Connectez-vous avec

Connectez-vous avec le système, est un moyen rapide et pratique pour les gens de créer des comptes et de se connecter à votre application. Notre système de connexion avec permet deux scénarios, l'authentification et la demande d'autorisations pour accéder aux données des personnes. Vous pouvez utiliser la connexion avec le système simplement pour l'authentification ou 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://sofriend.net/api/oauth?app_id=YOUR_APP_ID">Log in With Sofriend</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 n'est valable que pour une utilisation unique, donc une fois que vous l'avez utilisé, vous ne pourrez plus l'utiliser et générer de nouveau code, vous devrez rediriger l'utilisateur vers la connexion avec le lien à nouveau.
Jeton d'accès

Une fois que vous avez obtenu l'approbation de l'utilisateur de votre Appli, connectez-vous à la fenêtre et renvoyez 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 savoir comment l'obtenir.

  1. Pour obtenir un jeton d'accès, envoyez une requête HTTP GET au point de terminaison 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
    
    $get = file_get_contents("https://sofriend.net/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
    
    $json = json_decode($get, true);
    if(!empty($json['access_token'])) {
        $access_token = $json['access_token']; // your access token
    }
    ?>
    Ce access_token valable seulement pour une heure seulement, donc une fois qu'il est invalide, vous devrez en créer un nouveau en redirigeant l'utilisateur vers la connexion avec le lien à nouveau.
APIs

Une fois que vous obtenez votre access_token Vous pouvez maintenant récupérer des informations de notre système via des requêtes HTTP GET qui prend en charge les paramètres suivants

Point final Description
api/get_user_info

obtenir des informations sur l'utilisateur

Vous pouvez récupérer les informations utilisateur comme ceci

if(!empty($json['access_token'])) {
   $access_token = $json['access_token']; // your access token
   $get = file_get_contents("https://sofriend.net/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": ""
    }
}