API Sürümü 1.1
Bu belgede, API'lerimizi başarılı bir şekilde kullanabilmeniz için uygulamanızı nasıl kaydedeceğiniz, yapılandıracağınız ve geliştireceğiniz açıklanmaktadır
Uygulama Oluştur
Uygulamanızın API'lerimize erişebilmesi için, uygulamanızı kullanarak kaydetmeniz gerekir Uygulama Kontrol Paneli. Kayıt, kim olduğunuzu bilmemizi sağlayan ve uygulamanızı diğer uygulamalardan ayırmamıza yardımcı olan bir Uygulama Kimliği oluşturur.
- Yeni bir Uygulama oluşturmanız gerekecek Yeni Uygulama Oluştur
- Uygulamanızı oluşturduğunuzda app_id ve app_secret
İle giriş
Sistemle Giriş Yap, insanların hesap oluşturması ve uygulamanızda oturum açması için hızlı ve kullanışlı bir yoldur. Birlikte Oturum Açma sistemimiz, kimlik doğrulama ve kişilerin verilerine erişim için izin isteme olmak üzere iki senaryoyu etkinleştirir. Login With sistemini yalnızca kimlik doğrulama için veya hem kimlik doğrulama hem de veri erişimi için kullanabilirsiniz.
-
OAuth giriş işlemini başlatırken, uygulamanız için aşağıdaki gibi bir bağlantı kullanmanız gerekir:
<a href="https://www.senoben.web.tr/api/oauth?app_id=YOUR_APP_ID">Log in With Senoben</a>
Kullanıcı şu şekilde Giriş Yap sayfasına yönlendirilecek
-
Kullanıcı uygulamanızı kabul ettikten sonra Uygulama Yönlendirme URL'nize yönlendirilecektir auth_key bunun gibi:
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
Bu auth_key yalnızca bir kerelik kullanım için geçerlidir, bu nedenle onu bir kez kullandıktan sonra tekrar kullanamayacaksınız ve yeni kod oluşturup kullanıcıyı tekrar bağlantıyla oturum açma sayfasına yönlendirmeniz gerekecek.
Erişim Jetonu
Uygulamanızın kullanıcı onayını aldıktan sonra Şununla Giriş Yap penceresiyle geri dönün auth_key bu, artık API'lerimizden veri almaya hazır olduğunuz anlamına gelir ve bu süreci başlatmak için uygulamanızı yetkilendirmeniz ve access_token ve bunu nasıl elde edeceğinizi öğrenmek için adımlarımızı takip edebilirsiniz.
-
Erişim belirteci almak için aşağıdaki uç noktaya aşağıdaki gibi bir HTTP GET isteği gönderin:
<?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 $get = file_get_contents("https://www.senoben.web.tr/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key"); $json = json_decode($get, true); if(!empty($json['access_token'])) { $access_token = $json['access_token']; // your access token } ?>
Bu access_token sadece 1 saat için geçerlidir, bu nedenle geçersiz olduğunda kullanıcıyı tekrar bağlantı ile oturum açmaya yönlendirerek yeni bir tane oluşturmanız gerekecektir.
API'ler
Bir kez aldığınızda access_token Artık aşağıdaki parametreleri destekleyen HTTP GET istekleri aracılığıyla sistemimizden bilgi alabilirsiniz
Son Nokta | Açıklama |
---|---|
api/get_user_info | kullanıcı bilgilerini al |
Kullanıcı bilgilerini şu şekilde geri alabilirsiniz
if(!empty($json['access_token'])) { $access_token = $json['access_token']; // your access token $get = file_get_contents("https://www.senoben.web.tr/api/get_user_info?access_token=$access_token"); }
Sonuç şöyle olacak:
{ "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": "" } }