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.1Crea 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
Dovrai creare una nuova app Crea nuova app
-
2
Dopo aver creato la tua app riceverai il tuo
app_ideapp_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
Per avviare la procedura di accesso OAuth, usa un link per la tua app come questo:
L’utente verrà reindirizzato a una pagina Accedi con come questaHTML
<a href="https://www.flexartsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexartsocial.com</a>
-
2
Quando l’utente accetta la tua app, verrà reindirizzato all’URL di reindirizzamento della tua app con
auth_keyin questo modo:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYQuestoauth_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.
<?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
}
?>
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
/api/get_user_info
ottieni le informazioni dell’utente
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");
}
{
"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": ""
}
}