Versione API 1.1

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

Crea app

Affinché la tua app accedono alle nostre API, devi registrare la tua app utilizzando la Dashboard dell'app. La registrazione crea un ID app che ci consente di sapere chi sei, ci aiuta a distinguere la tua app da altre app.

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

Accedi con

Accedere con il sistema è un modo rapido e conveniente per le persone di creare account e accedere alla tua app. Il nostro sistema di accesso con consente due scenari, l'autenticazione e la richiesta di autorizzazioni per accedere ai dati delle persone. È possibile utilizzare il sistema Login With semplicemente per l'autenticazione o sia per l'autenticazione che per l'accesso ai dati.

1. Avvio del processo di accesso OAuth, devi usare un link per la tua app come questo:

   <a href="https://www.scenario.press/api/oauth?app_id=YOUR_APP_ID">Log in With Scenario.press - libera espressione</a>

   L'utente verrà reindirizzato alla pagina Accedi con in questo modo

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

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

   Questo auth_key valido solo per un solo utlizzo, quindi una volta utilizzato non sarà possibile utilizzarlo di nuovo e dovrete generare nuovo codice sarà necessario reindirizzare l'utente all'accesso con il collegamento di nuovo.

Access Token

Una volta che hai l'approvazione dell'utente della tua app Accedi con la finestra di Log in e ritorna con il auth_key il che significa che ora sei pronto a riprovare i dati dalle nostre API e per avviare questo processo dovrai autorizzare la tua app e ottenere il access_token e puoi seguire i nostri passi per imparare come ottenerlo.

1. Per ottenere un token di accesso, effettuare una richiesta HTTP GET all'endpoint seguente in questo modo:

               <?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://www.scenario.press/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
               }
               ?>                                                                                                
                               

   Questo access_token valido solo per un'ora, quindi una volta che non è più valido sarà necessario generarne uno nuovo reindirizzando l'utente al log in di nuovo con il link.

API

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

È possibile recuperare informazioni utente in questo modo

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