Geliştiriciler | girbir.com

API Sürümü 1.1

Bu belgeler, 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şmesi için, uygulamanızı kullanarak kaydetmeniz gerekir. Uygulama Kontrol Paneli. Kayıt, kim olduğunuzu bilmemizi sağlayan bir Uygulama Kimliği oluşturur, bize yardımcı olur uygulamanızı diğer uygulamalardan ayırt edin.

Yeni bir Uygulama oluşturmanız gerekecek Yeni Uygulama Oluştur
Uygulamanızı oluşturduktan sonra, app_id ve app_secret

İle giriş

Sistemle Giriş Yap, insanların oluşturması için hızlı ve kolay bir yoldur hesaplar ve uygulamanıza giriş yapın. Log in With sistemimiz iki olanak sağlar senaryolar, kimlik doğrulama ve insanların erişimi için izin isteme veri. Login With sistemini yalnızca kimlik doğrulama veya her ikisi için kullanabilirsiniz.kimlik doğrulama ve veri erişimi.

OAuth giriş işlemini başlatırken, uygulamanız için aşağıdaki gibi bir bağlantı kullanmanız gerekir::
```
<a href="https://girbir.com/api/oauth?app_id=YOUR_APP_ID">Log in With girbir.com</a>
```
Kullanıcı şu şekilde Oturum Aç sayfasına yönlendirilecek
Kullanıcı uygulamanızı kabul ettikten sonra, şu şekilde Uygulama Yönlendirme URL'nize yönlendirilir: auth_key bunun gibi:
```
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
```
Bu auth_key sadece tek seferlik kullanım için geçerlidir, bu nedenle bir kez kullandıktan sonra tekrar kullanamazsınız.tekrar kullanın ve yeni kod oluşturun, kullanıcıyı yeniden yönlendirmeniz gerekecektekrar bağlantı ile giriş yap.

Erişim Jetonu

Uygulamanızın kullanıcı onayını aldıktan sonra Log in With penceresi ile geri dönün auth_key bu, artık API'larımızdan veri almaya hazır olduğunuz ve bu süreci başlatmak için uygulamanızı yetkilendirmeniz ve access_token ve nasıl alacağınızı öğrenmek için adımlarımızı takip edebilirsiniz..

Bir erişim belirteci almak için, aşağıdaki uç noktaya bunun gibi 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

            $get = file_get_contents("https://girbir.com/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 yalnızca bir 1 saat için geçerlidir, bu nedenle geçersiz hale geldiğinde, kullanıcıyı tekrar bağlantı ile oturum açmaya yönlendirerek yeni bir tane oluşturmanız gerekir..

API'ler

Seninkini aldıktan sonra access_token Artık aşağıdaki parametreleri destekleyen HTTP GET istekleri aracılığıyla sistemimizden bilgi alabilirsiniz.

Uç nokta	Açıklama
api/get_user_info	kullanıcı bilgisi al

Bunun gibi kullanıcı bilgilerini alabilirsiniz

            if(!empty($json['access_token'])) {
                $access_token = $json['access_token']; // your access token
                $get = file_get_contents("https://girbir.com/api/get_user_info?access_token=$access_token");
            }

Sonuç 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": ""
              }
            }