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ų.
- Turėsite sukurti naują programą Sukurti naują programėlę
- 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ų.
-
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
-
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.
-
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 Dabar galite gauti informaciją iš mūsų sistemos naudodami HTTP GET užklausas, kurios palaiko šiuos parametrus
Endpoint | Aprašymas |
---|---|
api/get_user_info |
get user info |
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"); }
Rezultatas bus:
{ "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": "" } }