Siblia

Geliştiriciler

Sunduğumuz geliştirici araçlarını keşfet

Bu belgeler, API’lerimizi kullanmak için uygulamanı nasıl kaydedeceğini, yapılandıracağını ve geliştireceğini anlatır

API sürümü 1.1

Uygulama oluştur

Uygulamanın API’lerimize erişebilmesi için onu şu araçla kaydetmelisin: Uygulama paneli. Kayıt işlemi, kim olduğunu bilmemizi sağlayan ve uygulamanı diğer uygulamalardan ayırt etmemize yardımcı olan bir uygulama kimliği (App ID) oluşturur.

  1. 1
    Yeni bir uygulama oluşturman gerekir Yeni uygulama oluştur
  2. 2
    Uygulamanı oluşturduğunda şunları alırsın: app_id ve app_secret

Bizimle giriş yap

“Bizimle giriş yap” sistemi, kişilerin uygulamanda hızlı ve kolay bir şekilde hesap oluşturup giriş yapmasını sağlar. Bu sistem iki senaryoya olanak tanır: kimlik doğrulama ve kişilerin verilerine erişim izni isteme. Sistemi yalnızca kimlik doğrulama için ya da hem kimlik doğrulama hem de veri erişimi için kullanabilirsin.

  1. 1 OAuth giriş sürecini başlatmak için uygulamanda şuna benzer bir bağlantı kullanmalısın:
    HTML
    <a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
    Kullanıcı şuna benzer bir “Bizimle giriş yap” sayfasına yönlendirilir
  2. 2 Kullanıcı uygulamanı onayladığında, uygulamanın yönlendirme URL’sine auth_key parametresiyle şu şekilde yönlendirilir:
    URL
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    Bu auth_key yalnızca bir kez kullanılabilir; kullandıktan sonra tekrar kullanamazsın. Yeni bir kod almak için kullanıcıyı yeniden giriş bağlantısına yönlendirmen gerekir.

Erişim token’ı (Access Token)

Kullanıcı “Bizimle giriş yap” penceresinde uygulamanı onaylayıp şu anahtarla geri döndüğünde: auth_key artık API’lerimizden veri almaya hazırsın demektir. Bu süreci başlatmak için uygulamanı yetkilendirmeli ve şunu almalısın: access_token ; nasıl alacağını aşağıdaki adımları izleyerek öğrenebilirsin.

Erişim token’ı (access token) almak için aşağıdaki uç noktaya şu şekilde bir HTTP GET isteği gönder:
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
}
?>
Bu access_token yalnızca 1 saat geçerlidir; süresi dolduğunda yeni bir tane oluşturmak için kullanıcıyı yeniden giriş bağlantısına yönlendirmen gerekir.

API’ler

Şunu aldıktan sonra: access_token artık aşağıdaki parametreleri destekleyen HTTP GET istekleriyle sistemimizden bilgi alabilirsin

GET /api/get_user_info kullanıcı bilgilerini al
Kullanıcı bilgilerini şu şekilde alabilirsin
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");
}
Sonuç şu şekilde olur:
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