API Version 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

Per consentire alla tua app di accedere alle nostre API, devi registrarla utilizzando App Dashboard. La registrazione crea un ID app che ci consente 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. Una volta creata la tua App otterrai il tuo app_id e app_secret

Accedi con

Il sistema "Accedi con" è un modo rapido e comodo per creare account e accedere alla tua app. Il nostro sistema "Accedi con" consente due scenari: l'autenticazione e la richiesta di autorizzazioni per l'accesso ai dati degli utenti. Puoi utilizzare il sistema "Accedi con" semplicemente per l'autenticazione o per entrambe le funzioni.

1. Per avviare il processo di accesso OAuth, devi utilizzare un collegamento per la tua app come questo:

   <a href="https://sacredatoz.com/api/oauth?app_id=YOUR_APP_ID">Log in With Sacred A to Z! </a>

   L'utente verrà reindirizzato alla pagina Accedi con questo nome

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

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

   Questo auth_key valido solo per un utilizzo una tantum, quindi una volta utilizzato non potrai più utilizzarlo e generare nuovo codice dovrai reindirizzare l'utente al login con il link di nuovo.

Access Token

Una volta ottenuta l'approvazione dell'utente per la tua app, accedi alla finestra e torna indietro con auth_key il che significa che ora sei pronto a recuperare i 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. Per ottenere un token di accesso, effettuare una richiesta HTTP GET al seguente endpoint 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://sacredatoz.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 un'ora, quindi una volta che non è più valido dovrai generarne uno nuovo reindirizzando l'utente al login con il link di nuovo.

APIs

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 informazioni utente in questo modo

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