Desarrolladores | Hot Secrets

Versión de la API 1.1

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

Crear aplicación

Para que tu aplicación acceda a nuestras APIs, debes registrarla usando el Panel de la aplicación. El registro crea un ID de aplicación que nos permite saber quién eres, y nos ayuda a distinguir tu aplicación de otras aplicaciones.

Necesitarás crear una nueva aplicación Crear nueva aplicación
Una vez que hayas creado tu aplicación, obtendrás tu app_id y app_secret

Iniciar sesión con

El sistema Iniciar sesión con es una forma rápida y conveniente para que las personas creen cuentas e inicien sesión en tu aplicación. Nuestro sistema Iniciar sesión con permite dos escenarios: autenticación y solicitud de permisos para acceder a los datos de las personas. Puedes utilizar el sistema Iniciar sesión con simplemente para autenticación o para ambos, autenticación y acceso a datos.

Para iniciar el proceso de inicio de sesión con OAuth, necesitas usar un enlace para tu aplicación como este:
```
<a href="https://hot-secrets.online/api/oauth?app_id=YOUR_APP_ID">Log in With Hot Secrets</a>
```
El usuario será redirigido a la página de inicio de sesión con de esta forma
Una vez que el usuario acepte tu aplicación, será redirigido a la URL de redirección de tu aplicación con auth_key como esta:
```
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
```
Esto auth_key Válido solo para un uso, por lo que una vez que lo utilices no podrás volver a usarlo y para generar un nuevo código deberás redirigir al usuario al enlace de inicio de sesión nuevamente.

Token de acceso

Una vez que obtengas la aprobación del usuario en la ventana Iniciar sesión con de tu aplicación and se retorne con el auth_key lo que significa que ahora estás listo para recuperar datos de nuestras APIs y para iniciar este proceso, necesitarás autorizar tu aplicación y obtener el access_token y puedes seguir nuestros pasos para aprender cómo obtenerlo.

Para obtener un token de acceso, realiza una solicitud HTTP GET al siguiente endpoint de la siguiente manera:

            <?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://hot-secrets.online/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
            }
            ?>

Esto access_token Válido solo por 1 hora, por lo que una vez que caduque, necesitarás generar uno nuevo redirigiendo al usuario al enlace de inicio de sesión nuevamente.

APIs

Una vez que obtengas tu access_token Ahora puedes recuperar información de nuestro sistema mediante solicitudes HTTP GET que soportan los siguientes parámetros

Punto de acceso	Description
api/get_user_info	obtener información del usuario

Puedes obtener la información del usuario de la siguiente manera

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