Versión de API 1.1

Esta documentación explica cómo registrar, configurar y desarrollar tu aplicación para que puedas usar con éxito nuestras API

Crear aplicación

Para que su aplicación acceda a nuestras API, debe registrar su aplicación mediante el Panel de aplicaciones. El registro crea una ID de aplicación que nos permite saber quién eres tu, nos ayuda a distinguir tu aplicación de otras aplicaciones.

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

Inicia con

Iniciar sesión con el sistema es una forma rápida y conveniente para que las personas creen cuentas e inicien sesión en su aplicación. Nuestro sistema Iniciar sesión con 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 simplemente autenticación o para autenticación y acceso a datos.

1. Al iniciar el proceso de inicio de sesión de OAuth, debe usar un enlace para su aplicación como este:

   <a href="https://hookmi.com/api/oauth?app_id=YOUR_APP_ID">Log in With HOOKMI</a>

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

   
2. Una vez que el usuario haya aceptado su aplicación, será redirigido a la URL de redirección de su aplicación con auth_key me gusta:

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

   Este auth_key válido solo para un uso único, por lo que una vez que lo haya usado no podrá volver a usarlo y generar un código nuevo, 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 comenzar este proceso, deberá autorizar su aplicación y obtener la access_token y puedes seguir nuestros pasos para saber cómo conseguirlo.

1. Para obtener un token de acceso, realice una solicitud HTTP GET al siguiente punto final 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://hookmi.com/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
               }
               ?>                                                                                                
                               

   Este access_token válido solo por una hora, por lo que una vez que se vuelva invá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

Puede 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://hookmi.com/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": ""
              }
            }