Documentación

API Version 1.1

Esta documentación explica cómo registrar, configurar y desarrollar su aplicación para que pueda utilizar nuestras API con éxito.

Crear App

Para que su aplicación acceda a sus API, debe registrar su aplicación utilizando el Panel de desarrolladores. El registro crea una ID de aplicación que nos permite saber quién es usted y nos ayuda a distinguir su aplicación de otras aplicaciones..

  1. Deberás crear una nueva aplicación. Crear nueva aplicación
  2. Una vez que haya creado su aplicación, obtendrá su app_id y app_secret
Inicia con

Iniciar sesión con el sistema de Holax es una forma rápida y conveniente para que las personas creen cuentas e inicien sesión en su aplicación. Nuestro sistema para Iniciar sesión permite dos escenarios, la autenticación y la solicitud de permisos para acceder a los datos de las personas. Puede usar el sistema Iniciar sesión con simplemente para la autenticación o para la autenticación y el acceso a los datos..

  1. Para iniciar el proceso de inicio de sesión de OAuth, debe utilizar un enlace para su aplicación como este::
    <a href="https://holax.net/api/oauth?app_id=YOUR_APP_ID">Log in With HolaX</a>

    El usuario será redirigido a Iniciar sesión con una página como esta

  2. Una vez que el usuario aceptó su aplicación, será redirigido a la URL de redireccionamiento de su aplicación con auth_key como esto:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Esta auth_key sea valida solo para un uso único, por lo que una vez que lo haya usado no podrá volver a usarlo y debera generar un nuevo código, deberá redirigir al usuario al inicio de sesión con el enlace nuevamente..
Token de acceso

Una vez que obtenga la aprobación del usuario de su aplicación, inicie sesión con la ventana y regrese con el auth_key lo que significa que ahora está listo para recuperar datos de nuestras API y para iniciar este proceso deberá autorizar su aplicación y obtener el access_token y podrás seguir sus pasos para aprender cómo conseguirlo..

  1. Para obtener un token de acceso, realice una solicitud HTTP GET al siguiente EndPoint como este:
                <?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://holax.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
                }
                ?>                                                                                                
                                
    Esta access_token válido solo por una hora, por lo que una vez que ya no sea válido, deberá generar uno nuevo redirigiendo al usuario al inicio de sesión con el enlace nuevamente.
APIs

Una vez que obtenga su access_token Ahora puede recuperar información de nuestro sistema a través de solicitudes HTTP GET que admiten los siguientes parámetros

Endpoint Descripcion
api/get_user_info

Obtener información de usuario

Puedes recuperar información de usuario como esta.

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

El resultado será:

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