Siblia

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.1

Creează 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. 1
    Va trebui să creezi o aplicație nouă Creează aplicație nouă
  2. 2
    După ce creezi aplicația, vei primi app_id și app_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. 1 Pentru a începe procesul de conectare OAuth, folosește un link pentru aplicația ta, ca acesta:
    HTML
    <a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
    Utilizatorul va fi redirecționat către o pagină Conectare cu, ca aceasta
  2. 2 După ce utilizatorul acceptă aplicația, va fi redirecționat către URL-ul de redirecționare al aplicației, împreună cu auth_key astfel:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Acest auth_key este 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.

Pentru a obține un token de acces, trimite o cerere HTTP GET către următorul endpoint, astfel:
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://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
}
?>
Acest 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

GET /api/get_user_info obține informațiile utilizatorului
Poți prelua informațiile utilizatorului astfel
PHP
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");
}
Rezultatul va fi:
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": ""
  }
}
© 2026 Siblia