API Version 1.1

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

Create App

Pour que votre application puisse accéder à nos API, vous devez enregistrer votre application à l’aide du bouton App Dashboard. 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. You will need to create a new App Create New App
2. Once you created your App you will get your app_id and app_secret

Log in With

Se connecter 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 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 Connexion avec le système simplement pour l’authentification ou pour l’authentification et l’accès aux données.

1. Démarrage du processus de connexion OAuth, vous devez utiliser un lien pour votre application comme celui-ci:

   <a href="https://ecv.vn/api/oauth?app_id=YOUR_APP_ID">Log in With ECV Cyber</a>

   The user will be redirect to Log in With page like this

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

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

   This auth_key Valide uniquement pour une utilisation unique, donc une fois que vous l’avez utilisé, vous ne pourrez plus l’utiliser et générer un nouveau code, vous devrez rediriger l’utilisateur vers le lien de connexion avec.

Access Token

Une fois que vous avez obtenu l’approbation de l’utilisateur de votre application Connectez-vous avec la fenêtre et renvoyée avec le auth_key ce qui signifie que vous êtes maintenant prêt à récupérer des données à partir de nos API et pour démarrer ce processus, vous devrez autoriser votre application et obtenir le access_token and you can follow our steps to learn how to get it.

1. Pour obtenir un jeton d’accès, effectuez une requête HTTP GET vers le 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://ecv.vn/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
   }
   ?>

   This access_token Valide seulement pour une seule 1 heure, donc une fois qu’il est devenu invalide, vous devrez en genarte nouveau en redirigeant l’utilisateur vers le lien de connexion avec à nouveau.

APIs

Once you get your access_token Maintenant, vous pouvez récupérer des informations de notre système via des requêtes HTTP GET qui prend en charge les paramètres suivants

You can retrive user info like this

if(!empty($json['access_token'])) {
   $access_token = $json['access_token']; // your access token
   $get = file_get_contents("https://ecv.vn/api/get_user_info?access_token=$access_token");
}

The result will be:

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