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.1Uygulama 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
Yeni bir uygulama oluşturman gerekir Yeni uygulama oluştur
-
2
Uygulamanı oluşturduğunda şunları alırsın:
app_idveapp_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
OAuth giriş sürecini başlatmak için uygulamanda şuna benzer bir bağlantı kullanmalısın:
Kullanıcı şuna benzer bir “Bizimle giriş yap” sayfasına yönlendirilirHTML
<a href="https://siblia.com/api/oauth?app_id=YOUR_APP_ID">Log in With Siblia</a>
-
2
Kullanıcı uygulamanı onayladığında, uygulamanın yönlendirme URL’sine
auth_keyparametresiyle şu şekilde yönlendirilir:URLhttps://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEYBuauth_keyyalnı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.
<?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 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
/api/get_user_info
kullanıcı bilgilerini al
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": ""
}
}