API Верзија 1.1

Оваа документација објаснува како да се регистрирате, конфигурирате и развиете вашата апликација за да можете успешно да ги користите нашите AПИ

Креирај апликација

За да може вашата апликација да пристапи до нашите AПИ, мора да ја регистрирате вашата апликација со користење на Апликациска табла. Регистрацијата создава ИД на апликација која ни овозможува да знаеме кој сте, ни помага да ја разликуваме вашата апликација од другите апликации.

1. Ќе треба да создадете нова Апликација Креирај нова апликација
2. Кога ќе ја создадеш твојата Апликација ќе ја добиеш твојата app_id и app_secret

Најави се со

Логирајте се со системот е брз и погоден начин луѓето да креираат сметки и да влезат во вашата апликација. Нашиот Логирај се со системот овозможува две сценарија, автентикација и барање дозволи за пристап до податоците на луѓето. Можете да го користите Login With system едноставно за автентикација или и за автентикација и пристап до податоци.

1. Започнувајќи го процесот на влез во OAuth, треба да користите линк за вашата апликација вака:

   <a href="https://kuku.mk/api/oauth?app_id=YOUR_APP_ID">Log in With Kuku Куку</a>

   Корисникот ќе биде пренасочуван на Логирај се со страница вака

   
2. Кога корисникот ќе ја забрза вашата апликација, корисникот ќе биде пренасочен на вашиот URL за пренасочување на апликацијата со auth_key како ова:

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

   Ова auth_key валиден само за еднаш користење, па откако ќе го искористите нема да можете да го користите повторно и да генерирате нов код ќе треба да го пренасочите корисникот на логирањето со линк повторно.

Пристапен Токен

Откако ќе го добиете корисничката одобрување на вашата апликација Логирајте се со прозорецот и вратете се со auth_key што значи дека сега сте подготвени да ги повратите податоците од нашите 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://kuku.mk/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 важи само за еден час, па откако ќе добие неважечка ќе треба да генарте нов со пренасочување на корисникот на логирајте се со линк повторно.

АПИ

Кога ќе го добиеш твојот access_token Сега можете да ги извлечете информациите од нашиот систем преку HTTP GET барања кои ги поддржуваат следниве параметри

Можете да го ретрицирате корисникот инфо вака

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