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://www.flexsocialbox.com/api/oauth?app_id=YOUR_APP_ID">Log in With flexsocialbox.com</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://www.flexsocialbox.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://www.flexsocialbox.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": ""
  }
}