نسخه API 1.1

این مستندات نحوه ثبت، پیکربندی و توسعه برنامه خود را توضیح می دهد تا بتوانید از رابط ها استفاده کنید.برنامه نویسی برنامه های ما با موفقیت

ایجاد اپلیکیشن

برای اینکه برنامه شما به API های ما دسترسی پیدا کند، باید برنامه خود را با استفاده از داشبورد برنامه ثبت کنید. ثبت برنامه یک شناسه برنامه ایجاد می کند که به ما اطلاع می دهد شما که هستید و به ما کمک می کند برنامه شما را از برنامه های دیگر تشخیص دهیم .

1. شما باید یک برنامه جدید ایجاد کنید ایجاد برنامه جدید
2. هنگامی که برنامه خود را ایجاد کردید، برنامه خود را دریافت خواهید کرد app_id و app_secret

ورود به سیستم با

ورود به سیستم یک راه سریع و راحت برای افراد برای ایجاد حساب کاربری است. وارد اپلیکیشن شوید. سیستم ورود ما دو سناریو را امکان پذیر می کند، احراز هویت و درخواست مجوز برای دسترسی به داده های افراد. می توانید از سامانه ثبت نام استفاده کنید.برای احراز هویت یا احراز هویت و دسترسی به داده ها، به سادگی وارد شوید..

1. برای شروع فرآیند ورود به سیستم OAuth، باید از پیوندی برای برنامه خود مانند این استفاده کنید::

   <a href="https://geelgo.com/api/oauth?app_id=YOUR_APP_ID">Log in With گیلگو - شبکه اجتماعی ایرانی برای تبلیغات رایگان و کسب درآمد</a>

   کاربر به صفحه Log in With مانند این هدایت می شود

   
2. هنگامی که کاربر برنامه شما را پذیرفت، کاربر به URL برنامه مجدد هدایت می شود. با استفاده از برنامه را مستقیم کنید auth_key مثل این:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   این auth_key این فقط برای یک بار استفاده است، بنابراین پس از استفاده از آن نمی توانید دوباره از آن استفاده کنید. دیگر و ایجاد یک توکن جدید، باید کاربر را برای ورود به سیستم هدایت کنید.استفاده مجدد از لینک.

رمز دسترسی

پس از تأیید کاربر برای برنامه خود، با استفاده از پنجره وارد شوید. و آن را با پسوند برگردانید auth_key یعنی اکنون آماده بازیابی داده ها از API های ما هستید.برای شروع این فرآیند، باید مجوز برنامه خود را صادر کرده و یک A را دریافت کنید access_token و می توانید مراحل ما را دنبال کنید تا نحوه دریافت آن را بیاموزید.

1. برای دریافت یک نشانه دسترسی، یک درخواست HTTP GET را به نقطه پایانی زیر انجام دهید::

                                                   <?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://geelgo.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
                                                   }
                                                   ?>                                                                                                
                                                                   

   این access_token فقط برای یک ساعت معتبر است، بنابراین پس از نامعتبر بودن، باید a را ایجاد کنیدیک مورد جدید با هدایت کاربر برای ورود به سیستم با استفاده از پیوند یک باردیگر.

API ها

هنگامی که شما خود را دریافت کنید access_token اکنون می توانید از طریق درخواست های HTTP GET که از پارامترها پشتیبانی می کنند، اطلاعات را از سیستم خود بازیابی کنید.بعدی

شما می توانید اطلاعات کاربر را مانند این بازیابی کنید

                                                if(!empty($json['access_token'])) {
                                                    $access_token = $json['access_token']; // your access token
                                                    $get = file_get_contents("https://geelgo.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": ""
                                                  }
                                                }