المطوّرون

لكي يتمكن تطبيقك من الوصول إلى واجهات API الخاصة بنا، يجب تسجيله عبر لوحة تحكم التطبيقات. يُنشئ التسجيل معرّف تطبيق (App ID) يعرّفنا بك ويساعدنا على تمييز تطبيقك عن التطبيقات الأخرى.

1. 1
   ستحتاج إلى إنشاء تطبيق جديد إنشاء تطبيق جديد
2. 2
   بعد إنشاء تطبيقك ستحصل على app_id و app_secret

يُعدّ نظام «تسجيل الدخول عبر» طريقة سريعة ومريحة لإنشاء الحسابات وتسجيل الدخول إلى تطبيقك. يتيح نظامنا سيناريوهين: المصادقة، وطلب الصلاحيات للوصول إلى بيانات الأشخاص. يمكنك استخدامه للمصادقة فقط أو للمصادقة والوصول إلى البيانات معًا.

1. 1 لبدء عملية تسجيل الدخول عبر OAuth، استخدم رابطًا لتطبيقك مثل هذا:
   HTML نسخ

   <a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>

   ستتم إعادة توجيه المستخدم إلى صفحة «تسجيل الدخول عبر» كما يلي
   
2. 2 بعد موافقة المستخدم على تطبيقك، ستتم إعادة توجيهه إلى رابط إعادة التوجيه الخاص بتطبيقك مع auth_key كما يلي:
   URL نسخ

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

   هذا auth_key صالح للاستخدام مرة واحدة فقط، فبعد استخدامه لن تتمكن من استخدامه مجددًا، ولإنشاء رمز جديد ستحتاج إلى إعادة توجيه المستخدم إلى رابط «تسجيل الدخول عبر» مرة أخرى.

بعد أن يوافق المستخدم على تطبيقك في نافذة «تسجيل الدخول عبر» ويعود ومعه auth_key فهذا يعني أنك أصبحت جاهزًا لجلب البيانات من واجهات API الخاصة بنا، ولبدء ذلك ستحتاج إلى تفويض تطبيقك والحصول على access_token ويمكنك اتباع خطواتنا لمعرفة كيفية الحصول عليه.

<?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 يمكنك الآن جلب المعلومات من نظامنا عبر طلبات HTTP GET التي تدعم المعاملات التالية

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": ""
  }
}