API Sürümü 1.1
Bu dokümantasyon, API'lerimizi başarıyla kullanabilmeniz için uygulamanızı nasıl kaydedeceğinizi, yapılandıracağınızı ve geliştireceğinizi açıklar
Uygulama Oluştur
Uygulamanızın API'lerimize erişebilmesi için uygulamanızı şunları kullanarak kaydetmelisiniz: Uygulama Paneli. Kayıt işlemi, kim olduğunuzu bilmemizi sağlayan ve uygulamanızı diğer uygulamalardan ayırt etmemize yardımcı olan bir Uygulama Kimliği (App ID) oluşturur.
- Yeni bir Uygulama oluşturmanız gerekecek Yeni Uygulama Oluştur
- Uygulamanızı oluşturduktan sonra şunları alacaksınız: app_id ve app_secret
Şununla Giriş Yap:
'İle Giriş Yap' sistemi, insanların hesap oluşturması ve uygulamanıza giriş yapması için hızlı ve kolay bir yoldur. Sistemimiz iki senaryoya olanak tanır: kimlik doğrulama ve insanların verilerine erişmek için izin isteme. Sistemi sadece kimlik doğrulama için veya hem kimlik doğrulama hem de veri erişimi için kullanabilirsiniz.
-
OAuth oturum açma işlemini başlatmak için uygulamanız için bunun gibi bir bağlantı kullanmanız gerekir:
<a href="https://klingsocial.com/api/oauth?app_id=YOUR_APP_ID">Log in With Kling Social</a>
Kullanıcı bunun gibi bir 'İle Giriş Yap' sayfasına yönlendirilecektir
-
Kullanıcı uygulamanızı kabul ettiğinde, şununla birlikte Uygulama Yönlendirme URL'nize yönlendirilecektir: auth_key bunun gibi:
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
Bunun auth_key sadece bir kez kullanım için geçerlidir; bu nedenle bir kez kullandığınızda tekrar kullanamazsınız ve yeni kod oluşturmak için kullanıcıyı tekrar 'ile giriş yap' bağlantısına yönlendirmeniz gerekir.
Erişim Tokeni (Access Token)
Uygulamanız için kullanıcı onayını 'İle Giriş Yap' penceresinden alıp şununla döndüğünüzde: auth_key bu, artık API'lerimizden veri almaya hazır olduğunuz anlamına gelir ve bu işlemi başlatmak için uygulamanızı yetkilendirmeniz ve şunları almanız gerekir: access_token ve bunu nasıl alacağınızı öğrenmek için adımlarımızı izleyebilirsiniz.
-
Bir erişim tokeni (access token) almak için aşağıdaki uç noktaya şu şekilde bir HTTP GET isteği yapın::
<?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://klingsocial.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)); } curl_close($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 } ?>Bunun access_token sadece 1 saat geçerlidir; geçersiz olduğunda kullanıcıyı tekrar 'ile giriş yap' bağlantısına yönlendirerek yeni bir tane oluşturmanız gerekecektir.
API'ler
Şunu aldığınızda: access_token Artık aşağıdaki parametreleri destekleyen HTTP GET istekleri aracılığıyla sistemimizden bilgi alabilirsiniz
| Uç Nokta (Endpoint) | Açıklama |
|---|---|
| api/get_user_info | kullanıcı bilgisini al |
Kullanıcı bilgisini şu şekilde alabilirsiniz:
if(!empty($json['access_token'])) {
$access_token = $json['access_token']; // your access token
$get = file_get_contents("https://klingsocial.com/api/get_user_info?access_token=$access_token");
}
Sonuç şöyle olacaktır::
{
"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": ""
}
}