Versione API 1.1

Questa documentazione spiega come registrarsi, configurare e sviluppare la tua app in modo da poter utilizzare correttamente le nostre API

Crea App

Affinché la tua app possa accedere alle nostre API, devi registrarla utilizzando il Dashboard dell'App. La registrazione crea un ID App che ci permette di sapere chi sei, aiutandoci a distinguere la tua app dalle altre.

1. Dovrai creare una nuova App Crea Nuova App
2. Una volta creata l'App riceverai il tuo app_id e app_secret

Accedi con

Il sistema 'Accedi con' è un modo rapido e conveniente per le persone di creare account e accedere alla tua app. Il nostro sistema 'Accedi con' abilita due scenari: l'autenticazione e la richiesta di autorizzazioni per accedere ai dati delle persone. Puoi utilizzare il sistema 'Accedi con' semplicemente per l'autenticazione o sia per l'autenticazione che per l'accesso ai dati.

1. Avvio del processo di login OAuth; devi utilizzare un link per la tua app come questo:

   <a href="https://istigo.com/api/oauth?app_id=YOUR_APP_ID">Log in With Istigo - Beyond Social Network</a>

   L'utente verrà reindirizzato alla pagina di accesso come questa

   
2. Una volta che l'utente ha accettato la tua app, verrà reindirizzato all'URL di reindirizzamento della tua app con auth_key come questo:

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

   Questo auth_key valido solo per un singolo utilizzo; una volta usato, non potrai utilizzarlo di nuovo e dovrai generare un nuovo codice reindirizzando nuovamente l'utente al link di login.

Token di accesso

Una volta ottenuta l'approvazione dell'utente dalla finestra 'Accedi con' e restituito il auth_key il che significa che ora sei pronto per recuperare i dati dalle nostre API; per avviare questo processo dovrai autorizzare la tua app e ottenere il access_token e puoi seguire i nostri passaggi per imparare come ottenerlo.

1. Per ottenere un token di accesso, effettua una richiesta HTTP GET al seguente endpoint come questo:

   <?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://istigo.com/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
   }
   ?>
   

   Questo access_token valido solo per 1 ora; una volta scaduto, dovrai generarne uno nuovo reindirizzando nuovamente l'utente al link di login.

API

Una volta ottenuto il tuo access_token Ora puoi recuperare informazioni dal nostro sistema tramite richieste HTTP GET che supportano i seguenti parametri

Puoi recuperare le info dell'utente in questo modo

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

Il risultato sarà:

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