Versione API 1.1

Questa documentazione spiega come registrare, configurare e sviluppare la tua app in modo da poter utilizzare con successo le nostre API.

Crea App

TEXT: Affinché la tua app possa accedere alle nostre API, devi registrare la tua app utilizzando il Interfaccia App. La registrazione crea un ID App che ci permette di sapere chi sei e ci aiuta a distinguere la tua app dalle altre app..

1. Dovrai creare una nuova App Crea Nuova App
2. TESTO: Una volta creato la tua App, riceverai il tuo app_id e app_secret

Accedi con

Il sistema di accesso rapido è un modo veloce e conveniente per le persone di creare account e accedere alla tua app. Il nostro sistema di accesso consente due scenari: autenticazione e richiesta di permessi per accedere ai dati delle persone. Puoi utilizzare il sistema di accesso semplicemente per l'autenticazione o per entrambe le cose, autenticazione e accesso ai dati..

1. TESTO: Avviando il processo di accesso OAuth, devi utilizzare un link per la tua app come questo:

   <a href="https://saticula.com/api/oauth?app_id=YOUR_APP_ID">Log in With saticula</a>

   L'utente verrà reindirizzato alla pagina di accesso con questo aspetto.

   
2. TESTO: Una volta che l'utente ha accettato la tua app, verrà reindirizzato al tuo URL di reindirizzamento dell'app con auth_key Mi piace così:

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

   Questo auth_key Testo valido solo per un utilizzo, quindi una volta utilizzato non sarà possibile riutilizzarlo e generare un nuovo codice. Sarà necessario reindirizzare l'utente nuovamente al login con il link..

Token di accesso

Una volta ottenuta l'approvazione dell'utente per la tua app, accedi con la finestra e torna con il auth_key che significa che ora sei pronto per recuperare dati dalle nostre API e per iniziare questo processo dovrai autorizzare la tua app e ottenere il access_token e puoi seguire i nostri passaggi per scoprire come ottenerlo.

1. TEXT: Per ottenere un token di accesso, effettua 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
   
   // Prepare the POST data
   $postData = [
     'app_id' => $app_id,
     'app_secret' => $app_secret,
     'auth_key' => $auth_key
   ];
   
   // Initialize cURL
   $ch = curl_init('https://saticula.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 TESTO: valido solo per un'ora, quindi una volta che diventa non valido dovrai generare uno nuovo reindirizzando l'utente al login con il link di nuovo..

API

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

TEXT: Puoi recuperare le informazioni dell'utente in questo modo.

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