Versione API 1.1

Questa documentazione spiega come registrare, configurare e sviluppare l'app per usare le nostre API

Crea app

Per far accedere l'app alle API, registrala usando la Dashboard app. La registrazione crea un App ID che ci dice chi sei e distingue la tua app dalle altre.

1. Dovrai creare una nuova app Crea nuova app
2. Dopo aver creato l'app otterrai il tuo app_id e app_secret

Accedi con

Accedi con è un modo veloce per creare account e accedere alla tua app. Consente autenticazione e richiesta di permessi sui dati. Puoi usarlo solo per l'autenticazione o anche per l'accesso ai dati.

1. Per avviare il login OAuth, usa un link della tua app come questo:

   <a href="https://sngine-app.fluttercrafters.com/api/oauth?app_id=YOUR_APP_ID">Log in With Sngine Flutter Crafters</a>

   L'utente verrà reindirizzato alla pagina Accedi con, così

   
2. Quando l'utente accetta l'app, verrà reindirizzato all'URL di redirect con auth_key così:

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

   Questo auth_key valido una sola volta: dopo averlo usato dovrai reindirizzare di nuovo l'utente al link Accedi con per un nuovo codice.

Access Token

Dopo l'approvazione dell'utente nella finestra Accedi con e il ritorno con auth_key significa che sei pronto a recuperare i dati dalle API: per iniziare autorizza l'app e ottieni access_token e puoi seguire i nostri passaggi per ottenerlo.

1. Per ottenere un access token, fai una richiesta HTTP GET a questo endpoint:

           <?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://sngine-app.fluttercrafters.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: quando scade, reindirizza di nuovo l'utente al link Accedi con.

API

Quando hai il tuo access_token Ora puoi recuperare informazioni dal sistema con richieste HTTP GET che supportano questi parametri

Puoi recuperare le info utente così

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