កំណែ API 1.1

ឯកសារនេះពន្យល់ពីរបៀបចុះឈ្មោះ កំណត់រចនាសម្ព័ន្ធ និងអភិវឌ្ឍកម្មវិធីរបស់អ្នក ដូច្នេះអ្នកអាចប្រើ APIs របស់យើងដោយជោគជ័យ

បង្កើតកម្មវិធី

ដើម្បីឱ្យកម្មវិធីរបស់អ្នកអាចចូលប្រើ APIs របស់យើង អ្នកត្រូវតែចុះឈ្មោះកម្មវិធីរបស់អ្នកដោយប្រើពាក្យបញ្ជា ផ្ទាំងគ្រប់គ្រងកម្មវិធី. ការចុះឈ្មោះបង្កើតលេខសម្គាល់កម្មវិធីដែលអនុញ្ញាតឱ្យយើងដឹងថាអ្នកជានរណា ជួយយើងបែងចែកកម្មវិធីរបស់អ្នកពីកម្មវិធីផ្សេងទៀត.

1. អ្នកនឹងត្រូវបង្កើតកម្មវិធីថ្មី។ បង្កើតកម្មវិធីថ្មី។
2. នៅពេលអ្នកបង្កើត App របស់អ្នក អ្នកនឹងទទួលបានរបស់អ្នក។ app_id and app_secret

ចូល​ជា​មួយ​នឹង

ចូល​ជាមួយ​ប្រព័ន្ធ​គឺ​ជា​មធ្យោបាយ​លឿន និង​ងាយស្រួល​សម្រាប់​មនុស្ស​ក្នុង​ការ​បង្កើត​គណនី និង​ចូល​ក្នុង​កម្មវិធី​របស់​អ្នក។ ប្រព័ន្ធ Log in With របស់យើងបើកដំណើរការសេណារីយ៉ូពីរ ការផ្ទៀងផ្ទាត់ និងការស្នើសុំការអនុញ្ញាតដើម្បីចូលប្រើទិន្នន័យរបស់មនុស្ស។ អ្នកអាចប្រើ Login With system សម្រាប់ការផ្ទៀងផ្ទាត់ ឬសម្រាប់ការផ្ទៀងផ្ទាត់ និងការចូលប្រើទិន្នន័យ.

1. ចាប់ផ្តើមដំណើរការចូល OAuth អ្នកត្រូវប្រើតំណសម្រាប់កម្មវិធីរបស់អ្នកដូចនេះ:

   <a href="https://ifvex.com/api/oauth?app_id=YOUR_APP_ID">Log in With Ifvex</a>

   អ្នក​ប្រើ​នឹង​ត្រូវ​បាន​ប្ដូរ​ទិស​ទៅ​ចូល​ជាមួយ​ទំព័រ​ដូច​នេះ​

   
2. នៅពេលដែលអ្នកប្រើប្រាស់បានទទួលយកកម្មវិធីរបស់អ្នក អ្នកប្រើប្រាស់នឹងត្រូវបានបញ្ជូនបន្តទៅកាន់ URL ប្តូរទិសកម្មវិធីរបស់អ្នកជាមួយ auth_key ដូចនេះ:

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

   នេះ auth_key មានសុពលភាពសម្រាប់ការប្រើប្រាស់តែម្តងប៉ុណ្ណោះ ដូច្នេះនៅពេលដែលអ្នកបានប្រើវា អ្នកនឹងមិនអាចប្រើវាម្តងទៀតបានទេ ហើយបង្កើតកូដថ្មី អ្នកនឹងត្រូវប្តូរទិសអ្នកប្រើប្រាស់ទៅកាន់ការចូលដោយប្រើតំណម្តងទៀត។.

ចូលប្រើនិមិត្តសញ្ញា

នៅពេលដែលអ្នកទទួលបានការយល់ព្រមពីអ្នកប្រើប្រាស់នៃកម្មវិធីរបស់អ្នក Log in With window ហើយត្រលប់មកវិញជាមួយនឹង auth_key ដែលមានន័យថាឥឡូវនេះ អ្នកត្រៀមខ្លួនរួចរាល់ហើយក្នុងការទាញយកទិន្នន័យពី APIs របស់យើង ហើយដើម្បីចាប់ផ្តើមដំណើរការនេះ អ្នកនឹងត្រូវផ្តល់សិទ្ធិឱ្យកម្មវិធីរបស់អ្នក និងទទួលបាន 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://ifvex.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 មានសុពលភាពត្រឹមតែ 1 ម៉ោងប៉ុណ្ណោះ ដូច្នេះនៅពេលដែលវាមិនត្រឹមត្រូវ អ្នកនឹងត្រូវបង្កើតថ្មីមួយដោយប្តូរទិសអ្នកប្រើប្រាស់ទៅកាន់ការចូលដោយប្រើតំណម្តងទៀត។.

APIs

នៅពេលដែលអ្នកទទួលបានរបស់អ្នក។ access_token ឥឡូវនេះ អ្នកអាចទាញយកព័ត៌មានពីប្រព័ន្ធរបស់យើងតាមរយៈសំណើ HTTP GET ដែលគាំទ្រប៉ារ៉ាម៉ែត្រខាងក្រោម

អ្នកអាចទាញយកព័ត៌មានអ្នកប្រើប្រាស់ដូចនេះ

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