Çfarë funksionon me api në VK. Qasja e saktë për të përdorur API Vkontakte

24.06.2019 Siguria

Përshëndetje, Habr!

Në një kohë, duke lundruar në internet për përdorimin racional të API-së Vkontakte, nuk mund të gjeja diçka të kuptueshme, të vetmet biblioteka që gjeta u zbatuan pa përdorur ndonjë praktikë të pranuar përgjithësisht dhe pa kod të bukur. Vendosa ta korrigjoj këtë keqkuptim dhe shkrova bibliotekën time për të punuar me Vkontakte API.
Detaje të gjalla dhe qasje nën habrakat.

Kështu ndodhi që Vk API të zbatohet mjaft mirë, me përjashtim të disa pikave jo logjike, të cilat do t'i përmend më vonë. Por sot nuk po flasim për cilësi, por për një aplikim specifik.

Menjëherë është e nevojshme të bëni një rezervim, përveç përshkrimit, do të sjell në bibliotekën time pjesë të kodit të punës, një lidhje të cilës do ta jap në fund të artikullit. Biblioteka funksionon në versionin më të fundit të qëndrueshëm 5.5, nëse i hiqni gjeneratorët nga fatura e grupit, duhet të funksionojë në 5.4.

Autorizimi i serverit (i ashtuquajturi autorizimi i faqes)
Autorizimi i klientit (i pavarur)
Autorizimi i serverit të aplikacionit

Më interesantet për zhvilluesin janë dy të parat. E para ju lejon të autorizoni një përdorues në sit dhe të merrni çelësin e tij të hyrjes, e dyta ju lejon të autorizoni aplikacionin tuaj, për shembull Dekstop ose Mobile. Duke parë përpara, opsioni i dytë na ofron mundësi të jashtëzakonshme, dhe i pari, vetëm një pjesë e vogël e tyre.

Algoritmi për marrjen në rastin e parë reduktohet në zbatimin e pikave të mëposhtme:

Ne shfaqim një lidhje për autorizimin e përdoruesit, të cilën e formatojmë në përputhje me dokumentacionin
Përdoruesi e ndjek atë dhe identifikohet
Përdoruesi ridrejtohet në REDIRECT_URI të aplikacionit tonë me kodin e parametrit GET
Aplikacioni ynë duhet të bëjë një kërkesë në API që përmban kodin për të marrë shenjën e aksesit të përdoruesit
API përgjigjet ose me një objekt që përmban shenjën e aksesit ose me një gabim.

Një shembull i kodit me të cilin mund ta krijoni këtë nuk është një biznes i ndërlikuar.

$ auth = getjump \ Vk \ Auth :: getInstance (); $ auth-> setAppId ("3470411") -> setScope ("SCOPE") -> setSecret ("KODI SEKRET") -> setRedirectUri ("http: //localhost/test.php"); $ shenjë = $ auth-> startCallback (); printf ("LINK", $ auth-> getUrl ());

Supozohet se domeni ynë është localhost dhe skedari aktual është test.php. Nëse gjithçka shkoi mirë, atëherë ndryshorja jonë e shenjës $ do të përmbajë çelësin e aksesit të përdoruesit që ka kaluar autorizimin.

Nga momenti që kemi një çelës aksesi, ne mund të performojmë Kërkesat API... Logjika e përgjithshme e kërkesës është e thjeshtë, ju kaloni një kërkesë të krijuar posaçërisht në URL-në API. Kërkesa duhet të përmbajë emrin e metodës dhe argumentet.

api.vk.com/method/METHOD_NAME?PARAMETERS&access_token=ACCESS_TOKEN

Lista e metodave, kjo është një nga gjërat e pasura në API. Në të, mund të gjeni metoda që nuk kërkojnë një çelës aksesi për punën e tyre, prandaj mund t'i telefononi pa marrë atë.

Kur përdorim një bibliotekë, duhet të krijojmë një objekt bazë, si ky:
$ vk = getjump \ Vk \ Core :: getInstance () -> apiVersion ("5.5") -> setToken (token $);

Disa pyetje shembuj duke përdorur bibliotekën:

Saktësisht 100 objekte që përmbajnë të dhëna të përdoruesit nga 1 në 100 do të kalojnë përmes funksionit anonim në secilin. Vini re se nëse heqim thirrjen e funksionit, nuk do të bëhet asnjë kërkesë, e gjitha sepse do të kthehet një objekt që ka metodat magjike __call dhe __get anashkalohen , që na lejon të bëjmë një kërkesë kur kemi vërtet nevojë për të.
$ vk-> kërkesë ("users.get", ["user_ids" => diapazoni (1, 100)]) -> secili (funksioni ($ i, $ v) (nëse ($ v-> mbiemri == "" ) ktheni; printoni $ v-> mbiemrin.
"; });

Një nga gjërat që na zbulon përdorimin e gjeneratorëve është marrja e grupeve. Kjo do të thotë, ne marrim të dhëna vetëm kur na duhen. Shembulli i mëposhtëm do të na lejojë të marrim TË GJITHA mesazhet tona, kërkesat për 100. Kini kujdes, metodë kërkon që ju të keni të drejta për mesazhe, aplikacion të pavarur, të njëjtin autorizim dhe, në përputhje me rrethanat, transferimin e çelësit të hyrjes.
foreach ($ vk-> kërkesë ("messages.get") -> grumbull (100) si të dhëna $) ($ të dhëna-> secili (funksion ($ i, $ m) (nëse (isset ($ m-> trup) ) printoni $ m-> trupin. PHP_EOL;));)

Një metodë e mirë për të kërkuar në API është ekzekutuar... Ai merr një parametër kodi si argument, kodi është një lloj pseudo JavaScript që na lejon të ekzekutojmë kodin tonë në anën e serverit, dhe gjithashtu na lejon të ekzekutojmë procedurat e ruajtura që mund të krijojmë gjatë redaktimit të aplikacionit tonë.

Unë nuk mund ta shpërfillja këtë gjë dhe e zbatova në bibliotekë. Me pak fjalë, ju lejon të ekzekutoni pyetje të shumta si një. Shihni shembullin e mëposhtëm të kodit.

$ js1 = $ vk-> kërkesë ("messages.get", ["count" => 200, "offset" => 0 * 200]) -> toJs (); // Kthen një objekt të tipit VkJs $ js2 = $ vk-> kërkesë ("messages.get", ["count" => 200, "offset" => 1 * 200]) -> toJs (); $ js3 = $ vk-> kërkesë ("messages.get", ["count" => 200, "offset" => 2 * 200]) -> toJs (); $ js4 = $ vk-> kërkesë ("messages.get", ["count" => 200, "offset" => 3 * 200]) -> toJs (); $ js1 -> append ($ js2) // Ne shtojmë js2 në js1 -> append ($ js3) -> append ($ js4) -> ekzekutojmë () // Ne duam ta bëjmë këtë (në fakt kthen RequestTransaction) - > përgjigje // Kërkesa do të ekzekutohet vetëm tani -> secili (funksioni ($ i, $ v) // Funksioni i parë anonim nevojitet për të përshkuar të gjithë elementët e grupit të marrë nga ekzekutimi (një grup prej 4 elementësh, 4 kërkesa ) ($ v-> secili (funksioni ($ c, $ d) (// Tjetra për të kaluar nëpër të gjitha 200 mesazhet në çdo grup nëse (isset ($ d-> trup)) printoni $ d-> trupin; // Printoni një mesazh nëse një fushë e tillë është e pranishme));) );

Siç u premtua, një nga ato keqkuptime që mund të hasni në versionin aktual të API (5.21) është metoda

Rrjetet sociale janë bërë një mjet i domosdoshëm për promovimin e faqeve të internetit. Për promovimin e faqes në internet përmes sociale. rrjet, duhet të krijoni një grup ose faqe për këtë sajt. Fitoni abonentë, postoni lajme në mur dhe shumë më tepër (kjo është një temë për një artikull të veçantë). Shumë nga këto procese mund të automatizohen duke përdorur API (Application Programming Interface) të rrjetit social përkatës. Në këtë postim, unë do të analizoj se si të lidheni me vk api (vkontakte), si të filloni të punoni me vk api, si dhe të jap disa shembuj të punës me vk api.

Krijimi i një aplikacioni VKontakte

Dhe kështu le të fillojmë. Vk api ka shumë metoda, por një nga ndryshimet kryesore të tyre është se për të bërë kërkesa në Vk api përmes disa metodave, kërkohet një çelës i veçantë aksesi - një shenjë (access_token). Mund ta merrni duke krijuar aplikacionin tuaj. Na ofrohen disa lloje aplikacionesh, por unë zgjedh tipin Standalone. Më mjafton. Për të filluar krijimin e një aplikacioni, ndiqni lidhjen dhe futuni në dritaren tjetër.

Këtu ne zgjedhim llojin dhe emrin e aplikacionit tonë. Ne shtypim lidhjen e aplikacionit dhe marrim një SMS me një kod në numrin e telefonit të lidhur me llogarinë VK nga e cila krijojmë aplikacionin. Hyjmë në të dhe shkojmë në dritaren tjetër. Në këtë dritare, shkoni te skedari i cilësimeve.

Në skedën e cilësimeve, ne shohim fusha me emrin e ID-së së aplikacionit dhe çelësin e sigurisë. Këto të dhëna i shkruajmë diku. Nuk bëra asgjë tjetër në skeda. Gjendja e aplikacionit është lënë në pozicionin e çaktivizuar. Shtypim për të ruajtur cilësimet. Kjo është e gjitha, ne kemi krijuar një aplikacion VKontakte.

Marrja e një token (token_akses) api vk

Https://oauth.vk.com/authorize?client_id= & shfaq = [pamje e dritares]& redirect_uri = https: //oauth.vk.com/blank.html&scope= [të drejtat e aplikimit]& lloji_përgjigje = token & v = 5.52

klient_id - ID e aplikacionit tonë të marrë më herët.
shfaqja - pamja e dritares në të cilën do të bëhet autorizimi. Mund të jetë faqe, popup, prekje dhe wap
fushëveprimi - të drejtat e aksesit të aplikacionit tonë në lidhje me të dhënat e përdoruesit. Më shumë detaje rreth të drejtave më poshtë.

Të drejtat e aplikacionit VK në lidhje me një përdorues të caktuar mund të vendosen në formë teksti dhe dixhitale. Në tekst do të duket si fushëveprimi = miq, mesazhe, grupe. Me këtë linjë kodi, ne lejuam aplikacionin vk të aksesojë miqtë, mesazhet dhe grupet e përdoruesit. Të drejtat ndahen edhe në formë dixhitale. Për çdo rregull ka një maskë të vogël dhe shuma e këtyre maskave dhe do të lejojë që aplikacioni të bëjë disa gjëra. Për shembull, miqtë e duhur (+2), mesazhet (+4096), grupet (+262144), si rezultat, shuma e maskave të bitave do të jetë 266242 dhe shtrirja e kodit = 266242 do të jetë analoge me shtrirjen = miqtë, mesazhet , grupe. Dëshiroj t'i kushtoj vëmendje të veçantë ligjit offline. Vendosja e kësaj të drejte e bën tokenin që marrim të pafund. Nëse kjo e drejtë nuk vendoset pas një kohe të caktuar, token do të duhet të merret përsëri. Mund të lexoni më shumë rreth të drejtave të aplikacionit VK këtu. Si rezultat, le të hartojmë një adresë për marrjen e një token për një aplikacion me të drejta aksesi te miqtë, mesazhet dhe grupet e përdoruesve, si dhe me një shenjë të pavdekshme. Le të jetë ID e aplikacionit 123456. Kjo adresë do të duket si kjo:

Https://oauth.vk.com/authorize?client_id=123456&display=page&redirect_uri=https://oauth.vk.com/blank.html& fushëveprimi = miq, mesazhe, grupe, offline & lloji i përgjigjes = token & v = 5.52

Ne konfirmojmë veprimin dhe shkojmë në faqen e paralajmërimit, marrim shenjën tonë të marrë nga shiriti i adresave të shfletuesit. Kjo do të jetë pasi # access_token =, kodi exires_in = 0 na tregon se (token_akses) api vk është i pavdekshëm. Prandaj, user_id = është id i përdoruesit për të cilin kemi marrë shenjën.

Le të shkojmë te cilësimet e llogarisë në skedën e cilësimeve të aplikacionit dhe të shohim aplikacionin tonë.

Tani jemi gati të punojmë me api vkontakte.

Shembuj të punës me api vk

Për të punuar me api VK, unë përdor gjuhën e programimit php. Prandaj, unë do të jap shembuj në php. Për të kryer ndonjë veprim, duhet të dërgojmë një kërkesë në api vk. Ne gjithashtu mund të dërgojmë një kërkesë përmes shiritit të adresave të shfletuesit. Kjo do të thotë, një kërkesë është një adresë specifike url me parametra specifikë të specifikuar në të. Sintaksa për kompozimin e një url të tillë përshkruhet më poshtë.

Https://api.vkontakte.ru/method / [METODA E THIRRUR]?

Lista e metodave api vk është këtu. Ne nuk do të fokusohemi më shumë në këtë për momentin, pastaj në shembujt realë gjithçka do të bëhet e qartë. Mbetet vetëm për të kuptuar se si të dërgoni një kërkesë në api VKontakte duke përdorur php. Për ta bërë këtë, ne do të përdorim funksionin php file_get_contents, si dhe funksionin json_decode, pasi do të marrim përgjigjen nga serveri në formatin json. Këtu është një shabllon për të bërë një kërkesë në VK në php.

$ rezultat = json_dekodi (file_get_contents ("https://api.vkontakte.ru/ metoda / [METODA E THIRRUR]? [PARAMETRAT E METODËS SË THIRRUR]"));

mirë, tani disa shembuj të punës me api vk

$ userid = 12345; Mytoken $ = 56789; / * do të kthejë një objekt me gjininë dhe ditëlindjen e përdoruesit * / $ request_params = grup ("user_id" => $ userid, "fields" => "sex", "fields" => "bdate"); $ get_params = http_build_query ($ request_params); $ rezultat = json_dekodi (file_get_contents ("https://api.vk.com/method/users.get?". $ get_params)); / * kontrollimi i përdoruesit për një ndalim të VK-së * / $ request_params = grup ("user_id" => $ user_id, "fields" => "çaktivizohet"); $ get_params = http_build_query ($ request_params); $ rezultat = json_dekodi (file_get_contents ("https://api.vk.com/method/users.get?". $ get_params)); if (isset ($ rezultat-> përgjigja-> i çaktivizuar)) (jehonë "Faqja është e ngrirë ose e fshirë";) / * dërgoni një mesazh te përdoruesi me user_id = 222222 * / $ mesazh = "Përshëndetje, si jeni? "; // kodoni vargun $ msg = urlencode ($ mesazh); $ rezultat = json_dekodi (file_get_contents ("https://api.vkontakte.ru/method/ messages.send? user_id = 222222 & mesazh =". $ msg. "& access_token =". $ mytoken)); / * ftoni një përdorues me user_id = 222222 për të qenë miq * / $ mesazh = "Le të jemi miq"; $ msg = urlencode ($ mesazh); $ rezultat = json_dekodi (file_get_contents ("https://api.vkontakte.ru/ metoda / friends.adduser_id = 222222 & tekst =". $ msg. "& access_token =". $ mytoken));

Api ka shumë metoda, kështu që ju këshilloj të lexoni dokumentacionin. Natyrisht, pyetjet jo gjithmonë ekzekutohen si duhet dhe kthejnë kodet e gabimit. Gabimet mund të shihen këtu. Pra, ashtu si kjo, thjesht mund të lidheni me api vk dhe të automatizoni veprimet tuaja në kontakt.

Ata që vendosën të fillojnë të zhvillojnë aplikacione për VKontakte herët a vonë do të duhet të përballen me një koncept të tillë si API (ndërfaqja e programimit të aplikacionit), që fjalë për fjalë do të thotë ndërfaqe e programimit të aplikacionit.

Më thjesht - APIështë një kompleks i tërë funksionesh të ndryshme të gatshme, klasa të gatshme, konstante etj., të cilat mund të përdoren në palë të treta. VK API po përmirësohet vazhdimisht dhe sot është tashmë një grup shtesë plotësisht funksional që lejon.

Me dokumentacionin mund të njiheni në detaje këtu.
Transformimi i fundit i madh i këtij mjedisi zhvillimi u krye në prill 2009. Sigurisht, faqja u modifikua vazhdimisht pas kësaj. Le të shënojmë tiparet kryesore të API VKontakte

API u përdor për të zbatuar aksesin e aplikacioneve për miqtë, fotot, videot e tyre. Aplikimet munden tani krijoni në mënyrë të pavarur albume, vendosni informacione në to... Ky nuk ishte rasti më parë. Ajo që është e rëndësishme, kur instaloni një aplikacion të tillë, përdoruesi vendos vetë nëse do të hapë akses në të dhënat e tij personale apo jo.
Dërgimi i njoftimeve nga aplikacionet. Po, ndonjëherë është e bezdisshme njoftim pop-up në fund të majtë të ekranit është implementuar edhe në API.
Është gjithashtu më e lehtë të ftoni miqtë në aplikacione falë ndërfaqja e programimit të aplikacionit që zbatoi këtë veçori të ftesës në masë. Më pas, këto ftesa filluan të përdoren për reklama.
Reklamat nga VK u zhdukën nga faqet e aplikacionit. Tani zhvilluesi i lojës ose programit për VK vendos vetë nëse ka nevojë për reklamim në "flash drive"-in e tij. Nëse po, ai ka të drejtë të vendosë të tijën dhe të marrë prej saj 100% fitim.
Siç e quajtën zhvilluesit e VK, përdoruesit që integronin aplikacione fituan akses në ekonominë e brendshme të rrjetit. E thënë thjesht, një API është bërë i disponueshëm që lejon përdorni VKontakte si pagesa të brendshme.
Mundësi ekzekutoni aplikacionet në modalitetin e ekranit të plotë... Rritja e madhësisë maksimale të kornizës bëri të mundur vendosjen e banderolave shtesë me reklama, kështu që sot zhvillimi i aplikacioneve për VK nuk është vetëm një kënaqësi, por një aktivitet mjaft fitimprurës kur vendosni të angazhoheni në reklama, duke shitur banderola prej tij.
Aplikacionet e palëve të treta po shpërndahen tani dhe nëpërmjet burimit të lajmeve... Ky është një hap më shumë për t'i popullarizuar ato. Për më tepër (edhe pse ishte shumë kohë më parë, një ikonë miniaturë është bërë e disponueshme për aplikacionin).
Rendi i shfaqjes së aplikacionit implementuar edhe në API. Sot, si parazgjedhje, ato lojëra që lansohen më shpesh janë në pozicionet tuaja të para. Të cilat nuk janë përdorur për një kohë të gjatë - do t'i gjeni në fund të listës.
Falë API-së, ai u bë i disponueshëm dhe statistika të detajuara të integruara. Sot mund të numëroni lehtësisht vizitorët, shikimet e faqeve, gjininë, moshën, vendndodhjen e përdoruesit të aplikacionit. I gjithë informacioni paraqitet në mënyrën më vizuale, në formën e tabelave flash, të cilat ndërtohen në çast. Kjo bëhet kryesisht për reklamim (shitje të hapësirës reklamuese). Merr statistika, shikon që aplikacioni përdoret nga dhjetëra mijëra njerëz. Tregojeni këtë një reklamuesi që ndoshta do të dëshirojë të paguajë për një baner në një aplikacion të tillë.
Për aplikacionet më të njohura, u bë e mundur regjistrimi i nëndimeneve të shkurtra(për shembull chat.vk.com dhe të ngjashme) për memorizim të lehtë dhe akses të shpejtë.
Dhe së fundi, pati një mundësi shfaqja e informacionit në faqet personale të përdoruesve.

Më pyesin shpesh si të punoni me API... Detyra më e njohur në lidhje me API, eshte nje - punoni me VK API... Në këtë artikull do t'ju tregoj si të punoni me VK API, dhe, më e rëndësishmja, unë do t'ju tregoj këtë të gjitha API-të punojnë sipas të njëjtit parim.

Këtu procedurë për të cilën duhet të bëni filloni të punoni me çdo API:

Gjej dokumentacionin sipas nevojës API.
Shikoni Shembuj të lidhjes API... Mund të ketë opsione të ndryshme. Për shembull, një shërbim do të kërkojë një çelës sekret të lëshuar pas regjistrimit. Në shërbimin e dytë, të gjitha kërkesat nuk kërkojnë çelësa privatë. Në shërbimin e tretë, ka mundësi për të punuar me një çelës sekret dhe pa. Ndonjëherë thirret çelësi sekret shenjë.
Kopjo kod i thjeshtë i gatshëm nga faqja e dokumentacionit dhe kontrolloni nëse funksionon. Nëse nuk funksionon, atëherë kërkoni gabimin në veten tuaj, pasi shërbimi nuk ka gjasa ta ketë atë.
Gjej në dokumentacion metodë që zgjidh problemin tuaj.
Duke përdorur shembuj dhe përshkrim të metodës, dërgoni kërkesën e saktë në API.
Në varësi të formatit të përgjigjes, analizoje atë në " komponentët", dhe më pas bëni atë që kërkohet - nxirrni përdoruesit, ruani në një skedar, dërgoni në bazën e të dhënave dhe të ngjashme.

Dhe si shembull i ndjekjes së këtij udhëzimi, ne do të analizojmë API VKontakte... Kështu që:

Lidh me dokumentacionin.
Në këtë rast, ka metoda që janë të disponueshme publikisht, dhe për këtë arsye nuk kërkojnë një shenjë, por ka metoda që e kërkojnë atë.
Në këtë rast, unë nuk gjeta shembuj në një gjuhë specifike. Ndoshta janë, por qartësisht nuk janë në dukje. Zakonisht, në API ka shembuj në gjuhë të ndryshme për secilën metodë.
Ne duam të tërhiqemi 5 hyrjet e fundit nga muri i një përdoruesi specifik dhe më pas shfaqini ato në faqen tuaj... Metoda që na nevojitet.

Tani ne duhet dërgoni një kërkesë në API duke përdorur përshkrimin e metodës. Ne do ta bëjmë atë përmes PHP:

$ mur = file_get_contents ("https://api.vk.com/method/wall.get?v=5.3&filter=others&domain=myrusakov&count=5");
print_r ($ mur);
?>

Në këtë rast, unë jam duke përdorur API 5.3 (v = 5.3), i shfaq të gjitha hyrjet pavarësisht nga autori ( filtër = të tjerët) nga faqja juaj ( domen = myrusakov) në shumën 5 gjerat ( numërimi = 5). Mendoj se këtu gjithçka është shumë transparente.

Morëm një përgjigje në format Json, dhe tani duhet të kalojmë në pikën e fundit - të analizojmë përgjigjen për " komponentët". Më pas, ne do t'i shfaqim hyrjet nga muri në një formë pak a shumë të lexueshme në faqen e faqes sonë. Kodi Php:

$ mur = file_get_contents ("http://api.vk.com/method/wall.get?v=5.3&filter=others&domain=myrusakov&count=5"); // Dërgo kërkesën
$ mur = json_dekodi ($ mur); // Konvertoni vargun JSON në një grup
$ mur = $ mur-> përgjigje-> artikuj; // Merrni një sërë komentesh
për ($ i = 0; $ i< count($wall); $i++) {
jehonë"

". ($ i + 1).". ". $ mur [$ i] -> tekst."
".date (" Y-m-d H: i: s ", $ mur [$ i] -> data)."

"; // Shfaq të dhënat
}
?>

Siç mund ta shihni, gjithçka është shumë e thjeshtë. Pjesa më e vështirë është çmontimi i tij në elementët e tij përbërës. Unë preferoj të nxjerr daljen nga API përtej print_r, dhe vetëm atëherë shkruani trajtimin e kësaj. Edhe pse mund të shihni një shembull të një përgjigjeje në përshkrimin e metodës dhe më pas të shkruani një analizues.

Kemi publikuar një libër të ri, "Marketingu i përmbajtjes në mediat sociale: Si të hyni në krye të abonentëve dhe të bini në dashuri me markën tuaj".

API është një ndërfaqe programimi e jashtme për një aplikacion, duke iu referuar faqeve që përdorin një protokoll specifik për të marrë informacion dhe për të thjeshtuar zhvillimin e programeve që lidhen me shërbimet e brendshme.

Çfarë do të thotë API

Analogjia më e thjeshtë për përdorimin e API do të ishte procesi i punës në një kalkulator për llogaritjet komplekse. Le të themi se keni një problem, mund të kuptoni thelbin e tij, të ndërtoni ekuacione dhe grafikë, por nuk dini si të kryeni veprime aritmetike me numra. Pranë jush është një kalkulator që mund t'i kryejë këto operacione me lehtësi. Ju nuk e dini se çfarë po ndodh brenda kompjuterit dhe nuk keni nevojë ta dini atë. Ju jepni informacione në një formë dhe merrni në një tjetër, të nevojshme për qëllimet tuaja.

Çdo API funksionon sipas këtij parimi. Nuk ju intereson sesi programi e merr përgjigjen, në cilën rrugë kalon kërkesa brenda tij, si kryhen llogaritjet. Ju jeni të sigurt vetëm për një gjë - si përgjigje, do të merrni informacion të standardizuar në lidhje me suksesin e operacionit ose gabimin e tij.

Ndërfaqja API ju lejon të mos humbni kohën, paratë dhe përpjekjet tuaja për të blerë një "biçikletë të re". Ju merrni një portë të dhënash funksionale që merr dhe dërgon sasitë e nevojshme të të dhënave për zhvillimin tuaj.

Të mirat:

Kurseni në zhvillimin e ndërfaqes tuaj.
Nuk ka nevojë të kuptohen nuancat e çështjes.
API-të zhvillohen nga profesionistë dhe marrin parasysh të gjithë faktorët e proceseve të brendshme për të cilët mund të mos jeni në dijeni kur krijoni zgjidhjen tuaj.
Ju lejon të komunikoni me shërbime që mbyllen përmes protokolleve të tjera.

Minuset:

Nëse shërbimi i synuar përditësohet, API nuk merr gjithmonë funksionalitetin e plotë menjëherë.
Ju nuk mund të kapni gabimet dhe nuk e dini se si shkon procesi në kodin e dikujt tjetër.
API nuk jep gjithmonë rezultatin më të optimizuar për sa i përket kohës, pasi është krijuar për të trajtuar raste të përgjithshme, jo private.

Shembuj API

Integrimi API është procesi i lidhjes së një aplikacioni me një ndërfaqe të jashtme të të dhënave. Puna me API fillon me studimin e dokumentacionit dhe protokolleve të përdorura, dhe më pas integrimin e drejtpërdrejtë të programit tuaj në ndërfaqe. Le të shqyrtojmë shërbimet më të njohura që kanë API-në e tyre.

VKAPI

Ndërfaqja e jashtme e ndërveprimit të rrjetit social të njohur VKontakte me klientët, si dhe me aplikacionet e shfletuesit dhe serverit. Ju lejon të menaxhoni mesazhet nga komunitetet, kopertinat e grupeve, faqet e përdoruesve nëse keni çelësat e duhur të hyrjes.

Të gjitha kërkesat bëhen në adresë https://api.vk.com/method/

Vija pasohet nga emri i metodës API të përdorur dhe kalohen parametrat e kërkesës GET. Përgjigja vjen gjithashtu përmes HTTPS në formatin JSON.

API-ja e TELEGRAM BOT

Një nga API-të më të njohura. Përdoret për të kontrolluar robotët në mesazherin Telegram. Pas krijimit të një roboti përmes @botfather dhe marrjes së çelësave të kërkuar të aksesit, mund të filloni të ndërveproni me backend.

Kërkesat bëhen në https://api.telegram.org/bot0000000:token/

Ku, në vend të bot0000000, vendoset identifikuesi unik i robotit tuaj, dhe token shpreh çelësin sekret.

Kërkesat dërgohen përmes lidhjeve HTTPS, emri i metodës tregohet me një të pjerrët në adresën kryesore. Përgjigja vjen në format JSON.

HAPUR API-në e hartës së motit

Shpesh është e nevojshme të merrni informacione për motin pa përdorur miniaplikacione të palëve të treta dhe aplikacione me pagesë. Shërbimi OpenWeatherMap vjen në shpëtim me një API të hapur dhe falas. Pas regjistrimit dhe marrjes së të dhënave të identifikimit, mund të dërgoni kërkesa për motin në mbarë botën nga skriptet e serverit. Në përgjigje të ID-së së qytetit, burimi kthen informacionin më të detajuar në lidhje me motin aktual dhe jep një parashikim për të ardhmen e afërt.

Formati i punës: Transferimi HTTP nëpërmjet api.openweathermap.org/data/2.5/weather?id= duke treguar numrin e identifikimit të qytetit të dëshiruar. Përgjigja e serverit: JSON.

API-ja e GOOGLE MAPS

Çfarë mund të jetë më e bukur se një hartë interaktive e botës në faqen e internetit? Sidomos nëse kjo nuk është një insert shabllon nga Google Maps, por botimi juaj personal i një harte popullore me grupe shënuesish personalë. Harta do të ndërveprojë me skriptet e tjera në faqe, duke dërguar informacione rreth klikimeve dhe koordinatave.

Aftësi të ngjashme ofrohen nga JavaScript API Google Maps. Moduli është plotësisht i skriptuar dhe funksionon në anën e shfletuesit, kështu që nuk kemi nevojë për kërkesa HTTP nga PHP dhe formimin e titujve në anën e serverit, siç ishte në API-të e tjera.

Për shembull, vendosja e një etikete në një hartë do të duket kështu:

var mark = i ri google.maps.Marker ((
pozicioni: myPOS,
harta: harta,
titulli: "Përshëndetje!"
});

Për çfarë përdoret API dhe pse është i dobishëm?

Ka mjaft funksione të dobishme.

Aspekti i parë

Ju mund të krijoni një ndërveprim ndërveprues të përdoruesit me rrjetet sociale dhe lajmëtarët e çastit, të përdorni aftësitë e sistemeve kompjuterike të palëve të treta për të shfaqur kursin e këmbimit, motin dhe informacione të tjera të rëndësishme.

Duke përdorur API-në, mund të lidheni menjëherë me serverët e burimeve të tjera dhe zgjidhjeve softuerike, të cilat në një zbatim normal do të duheshin javë të tëra zhvillimi. Një API e bën jetën më të lehtë aty ku nuk keni nevojë për një zbatim unik dhe i jepni përparësi besueshmërisë dhe sigurisë.

Aspekti i dytë

Nëse jeni pronar i fuqisë kompjuterike komplekse, një shërbimi popullor ose një depo të dhënash për akses të hapur ose gjysmë privat, atëherë është një ide e mirë të ngrini API-në tuaj. Çfarë do të japë:

Fluks i madh klientësh.
Qasje e thjeshtuar në shërbimet tuaja për partnerët.
Lehtësia e analizës statistikore të përdorimit të shërbimit.

Aspekti i tretë

Pothuajse njësoj si e dyta. Por pa pasur nevojë të implementoni një API me burim të hapur. Nëse keni një portal dhe dëshironi të krijoni një aplikacion celular për të në Android / IOS, atëherë rishkrimi i sistemit për një API të vetëm është zgjidhja më e mirë. E gjithë struktura e të dhënave është e sistemuar. Faqja dhe aplikacioni do të funksionojnë përmes të njëjtave kanale të dhënash.