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 aplicación

Para que su aplicación pueda acceder a nuestras API, debe registrarla utilizando el App Dashboard. El registro crea un ID de aplicación que nos permite saber quién es usted y nos ayuda a distinguir su aplicación de otras aplicaciones..

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

Iniciar sesión con

El sistema de inicio de sesión es una forma rápida y cómoda de crear cuentas e iniciar sesión en tu aplicación. Nuestro sistema de inicio de sesión permite dos escenarios: autenticación y solicitud de permisos para acceder a los datos de los usuarios. Puedes usar el sistema de inicio de sesión solo para la autenticación o para ambas, autenticación y acceso a los datos..

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

   <a href="https://nosune.org/api/oauth?app_id=YOUR_APP_ID">Log in With NosUne</a>

   El usuario será redirigido a una página de inicio de sesión como esta

   
2. Una vez que el usuario haya aceptado 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

   This auth_key válido solo para un uso único, por lo que una vez que lo haya usado no podrá volver a usarlo y al generar un nuevo código deberá redirigir al usuario al inicio de sesión con el enlace nuevamente.

Access Token

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 de esta 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
   
           // Prepare the POST data
           $postData = [
             'app_id' => $app_id,
             'app_secret' => $app_secret,
             'auth_key' => $auth_key
           ];
   
           // Initialize cURL
           $ch = curl_init('https://nosune.org/api/authorize');
   
           // Set cURL options for POST
           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
           curl_setopt($ch, CURLOPT_POST, true);
           curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
   
           // Execute request
           $response = curl_exec($ch);
   
           // Check for cURL errors
           if (curl_errno($ch)) {
             die('cURL error: ' . curl_error($ch));
           }
   
           curl_close($ch);
   
           // Decode the JSON response
           $json = json_decode($response, true);
   
           // Use the access token if available
           if (!empty($json['access_token'])) {
             $access_token = $json['access_token']; // your access token
           }
           ?>
           

   This access_token válido solo por 1 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 obtengas tu access_token Ahora puede recuperar información de su sistema a través de solicitudes HTTP GET que admiten los siguientes parámetros

Puedes recuperar información del usuario de esta manera

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