API versija 1.1

Šioje dokumentacijoje paaiškinama, kaip užsiregistruoti, konfigūruoti ir kurti programą, kad galėtumėte sėkmingai naudoti mūsų API

Sukurti programą

Kad jūsų programa galėtų pasiekti mūsų API, turite užregistruoti programą naudodami Programų prietaisų skydelis. Registruojantis sukuriamas programos ID, kuris leidžia mums žinoti, kas esate, ir padeda atskirti jūsų programą nuo kitų programų.

1. Turėsite sukurti naują programą Sukurti naują programėlę
2. Sukūrę savo programą gausite savo app_id ir app_secret

Prisijungti su

Prisijungti Naudojant sistemą – tai greitas ir patogus būdas žmonėms susikurti paskyras ir prisijungti prie jūsų programėlės. Sistema „Prisijungti naudojant“ įgalina du scenarijus – autentifikavimą ir leidimo prieiti prie žmonių duomenų prašymą. Galite naudoti Login With sistemą tiesiog autentifikavimui arba tiek autentifikavimui, tiek prieigai prie duomenų.

1. Pradėdami „OAuth“ prisijungimo procesą, turite naudoti tokią savo programos nuorodą:

   <a href="https://rednet.lt/api/oauth?app_id=YOUR_APP_ID">Log in With Rednet</a>

   Vartotojas bus nukreiptas į prisijungimo naudojant puslapį kaip šis

   
2. Kai naudotojas patvirtins jūsų programą, jis bus nukreiptas į jūsų programos peradresavimo URL auth_key kaip šitas:

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

   Tai auth_key galioja tik vienkartiniam naudojimui, todėl pasinaudoję nebegalėsite jo naudoti ir generuoti naują kodą, turėsite vėl nukreipti vartotoją į prisijungimą su nuoroda.

Prieigos raktas

Kai gausite programos naudotojo patvirtinimą, prisijunkite naudodami langą ir grįžkite su auth_key Tai reiškia, kad dabar esate pasirengę gauti duomenis iš mūsų API ir pradėti šį procesą turėsite įgalioti programą ir gauti access_token ir galite sekti mūsų veiksmus, kad sužinotumėte, kaip jį gauti.

1. Norėdami gauti prieigos raktą, pateikite HTTP GET užklausą tokiam galutiniam taškui kaip šis:

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

   Tai access_token galioja tik 1 val., taigi, kai jis taps negaliojantis, turėsite sukurti naują, vėl nukreipdami vartotoją į prisijungimą su nuoroda.

APIs

Kai tik gausite savo access_token Now you can retrieve informations from our system via HTTP GET requests which supports the following parameters

Galite gauti tokią vartotojo informaciją

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

The result will be:

            {
              "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": ""
              }
            }