Dezvoltatori
Explorează instrumentele pentru dezvoltatori pe care le oferim
Această documentație explică cum să înregistrezi, să configurezi și să dezvolți aplicația, astfel încât să poți folosi API-urile noastre
Versiune API 1.1Creează aplicație
Pentru ca aplicația ta să poată accesa API-urile noastre, trebuie să o înregistrezi din tabloul de bord al aplicațiilor. Înregistrarea creează un ID de aplicație care ne permite să știm cine ești și ne ajută să deosebim aplicația ta de alte aplicații.
-
1
Va trebui să creezi o aplicație nouă Creează aplicație nouă
-
2
După ce creezi aplicația, vei primi
app_idșiapp_secret
Conectare cu
Sistemul Conectare cu este o modalitate rapidă și comodă prin care oamenii își pot crea conturi și se pot conecta la aplicația ta. Sistemul Conectare cu permite două scenarii: autentificarea și solicitarea permisiunii de a accesa datele persoanelor. Îl poți folosi doar pentru autentificare sau atât pentru autentificare, cât și pentru accesul la date.
-
1
Pentru a începe procesul de conectare OAuth, folosește un link pentru aplicația ta, ca acesta:
Utilizatorul va fi redirecționat către o pagină Conectare cu, ca aceastaHTML
<a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
-
2
După ce utilizatorul acceptă aplicația, va fi redirecționat către URL-ul de redirecționare al aplicației, împreună cu
auth_keyastfel:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYAcestauth_keyeste valabil o singură dată. După ce l-ai folosit, nu îl mai poți folosi din nou, iar pentru un cod nou trebuie să redirecționezi din nou utilizatorul către linkul Conectare cu.
Token de acces
După ce utilizatorul aprobă aplicația în fereastra Conectare cu și revine cu auth_key înseamnă că ești gata să preiei date din API-urile noastre. Pentru a începe, trebuie să autorizezi aplicația și să obții access_token și poți urma pașii noștri pentru a afla cum îl obții.
<?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://siblia.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 este valabil doar o oră. După ce expiră, trebuie să generezi altul redirecționând din nou utilizatorul către linkul Conectare cu.
API-uri
După ce obții access_token poți acum prelua informații din sistemul nostru prin cereri HTTP GET, care acceptă următorii parametri
/api/get_user_info
obține informațiile utilizatorului
if (!empty($json['access_token'])) {
$access_token = $json['access_token']; // your access token
$get = file_get_contents("https://siblia.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": ""
}
}