نگارش API 1.1

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

ایجاد برنامه

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

1. شما نیاز به ایجاد یک برنامه جدید دارید ایجاد اپلیکیشن جدید
2. هنگامی که برنامه خود را ایجاد کردید ، بدست خواهید آورد app_id و app_secret

وارد شوید با

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

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

   <a href="https://aslife.ir/api/oauth?app_id=YOUR_APP_ID">Log in With برای زندگی</a>

   کاربر مانند صفحه ای اینچنینی به سمت ورود به سیستم هدایت می شود

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

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

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

شناسه دسترسی

هنگامی که کاربر ورود از طریق برنامه شما را در این پنجره قبول کرد ، باز میگردد به auth_key این بدان معنی است که اکنون شما می توانید داده ها را از API های ما بازیابی کنید و برای شروع این فرآیند به مجوز برنامه خود نیاز دارید و 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://aslife.ir/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 فقط برای 1 ساعت معتبر است ، بنابراین پس از نامعتبر شدن ، باید با تغییر مسیر کاربر دوباره به سیستم وارد شوید و دوباره پیوند را وارد کنید.

API ها

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

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

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