Sviluppatori

Esplora gli strumenti per sviluppatori

Questa documentazione spiega come registrare, configurare e sviluppare la tua app per usare correttamente le nostre API

Versione API 1.1

Crea app

Per consentire alla tua app di accedere alle nostre API, devi registrarla tramite la dashboard delle app. La registrazione crea un ID app che ci permette di sapere chi sei e di distinguere la tua app dalle altre.

  1. 1
    Dovrai creare una nuova app Crea nuova app
  2. 2
    Dopo aver creato la tua app riceverai il tuo app_id e app_secret

Accedi con

Accedi con è un modo semplice e veloce per permettere alle persone di creare un account e accedere alla tua app. Il sistema Accedi con supporta due scenari: l’autenticazione e la richiesta di permessi per accedere ai dati delle persone. Puoi usarlo solo per l’autenticazione oppure sia per l’autenticazione sia per l’accesso ai dati.

  1. 1 Per avviare la procedura di accesso OAuth, usa un link per la tua app come questo:
    HTML
    <a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
    L’utente verrà reindirizzato a una pagina Accedi con come questa
  2. 2 Quando l’utente accetta la tua app, verrà reindirizzato all’URL di reindirizzamento della tua app con auth_key in questo modo:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Questo auth_key è valido una sola volta: dopo averlo usato non potrai riutilizzarlo e, per generare un nuovo codice, dovrai reindirizzare di nuovo l’utente al link Accedi con.

Token di accesso

Quando l’utente approva la tua app nella finestra Accedi con e ricevi il codice auth_key sei pronto a recuperare i dati dalle nostre API. Per iniziare, devi autorizzare la tua app e ottenere un access_token e puoi seguire i passaggi qui sotto per scoprire come ottenerlo.

Per ottenere un access token, invia una richiesta HTTP GET al seguente endpoint in questo modo:
PHP
<?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://www.flexartsocial.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));
}

// 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, dovrai generarne uno nuovo reindirizzando di nuovo l’utente al link Accedi con.

API

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

GET /api/get_user_info ottieni le informazioni dell’utente
Puoi recuperare le informazioni dell’utente in questo modo
PHP
if (!empty($json['access_token'])) {
  $access_token = $json['access_token']; // your access token
  $get = file_get_contents("https://www.flexartsocial.com/api/get_user_info?access_token=$access_token");
}
Il risultato sarà:
JSON
{
  "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": ""
  }
}