Ce este un API?

Publicat: 2020-07-27
Ce este un API?
Fotografie de Harry Parvin

Dacă lucrați cu tehnologie de ceva timp, probabil că ați întâlnit termenul API. Pentru cei care au programat și înțeleg cum să creeze un site web de la zero, veți fi foarte familiarizați cu termenul API.

Un API se află în spatele multor funcții populare pe care le utilizați pe site-uri web. Este un acronim care înseamnă Interfață de programare a aplicațiilor. O ilustrare bună ar fi să ne gândim la o rețetă pentru a face diferite tipuri de alimente. Fiecare rețetă are instrucțiuni pas cu pas despre cum se creează felul de mâncare. Acesta este codul care este implicat cu API. Un computer trebuie să urmeze un set de instrucțiuni pentru a îndeplini o sarcină.

Poți să iei acea rețetă și să o dai oricărui bucătar. Ei vor fi capabili să interpreteze ingredientele și să descopere cum să combine toate elementele diferite în produsul finit. Ai chiar posibilitatea să urmezi singur instrucțiunile pentru a pune cap la cap rețeta dacă înțelegi gătitul și ai suficientă pregătire pentru a folosi toate uneltele din bucătărie. Un API, în cele din urmă, este doar o rețetă pe care computerul înțelege cum să o urmeze.

Dezvoltatori și API-uri

Continuând cu ilustrarea noastră despre modul în care funcționează un API, unii vor aduce rețeta unui bucătar profesionist care poate pune rapid împreună mâncarea și vă poate oferi orice fel de mâncare comandați. Un dezvoltator este ca o persoană care deja poate crea rețeta și o poate modifica.

Un API este o serie de instrucțiuni către computer. Pentru un dezvoltator cu experiență în codificare, pot modifica unele aspecte ale API-ului și să-l modifice pentru a satisface nevoile lor. Acest lucru va depăși sfera multora care doresc doar să conecteze API-ul la site-ul lor.

Utilizarea unui API este bună pentru utilizatorii obișnuiți, deoarece le permite să obțină mai multe funcționalități de pe site-ul lor web fără a crea singuri codul. Poate ați dori să afișați vremea și ora pentru un utilizator care vă vizitează site-ul web. Acest conținut este dinamic și nu static. Nu poți doar să oprești vremea pentru o zi și să o lași. Valoarea se schimbă mereu, așa că trebuie să accesați un API pentru ca informațiile să se actualizeze.

API-uri și WordPress

Dacă utilizați WordPress și căutați o modalitate de a integra un API, vă recomandăm să o faceți printr-un plugin sau o temă WordPress. Multe pluginuri gratuite și premium vă pot ajuta să integrați destul de ușor API-urile. Cu toate acestea, majoritatea sunt foarte limitate, cu excepția cazului în care plătiți.

Dacă aveți cunoștințe de codificare, este simplu să integrați un API extern pe site-ul dvs. WordPress. Pentru asta, vă recomandăm acest ghid de la Rapidapi care explică cum să integrați API-uri externe.

Conținut dinamic

Ori de câte ori ai de-a face cu conținut dinamic, primul tău gând ar trebui să fie să găsești un API care să poată alimenta site-ul tău cu informații care se schimbă rapid. De asemenea, vă poate permite să interacționați cu programe populare la un nivel mai profund.

Luați, de exemplu, Twitter. Aceasta este o platformă populară pentru persoanele care sunt interesate de rețelele sociale. Dacă faci parte din marketingul digital, vei dori să accesezi lucrurile la un nivel mai profund. Folosind API-ul Twitter, puteți extrage rapid informații în foi de calcul pentru a le descompune și a afla lucruri precum interesele utilizatorilor și câte conexiuni au. Dacă sunteți un agent de marketing digital, veți dori să identificați rapid oamenii din anumite categorii demografice, astfel încât să știți ce produse să le prezentați. API-ul Twitter vă permite să faceți aceste lucruri, deoarece puteți extrage sume mari de informații dintr-o dată, în loc să compilați totul manual.

Îmbunătățirea site-ului dvs

Am analizat pe scurt cum vă puteți îmbunătăți afacerea folosind un API pentru o companie mare. Ce altceva putem extrage de pe site-uri externe? Pe lângă încărcarea vremii pentru un utilizator care se schimbă dinamic, putem afișa ceva mai interesant.

Cum ți-ar plăcea un site web care să poată afișa cele mai recente imagini de pe Flickr sau chiar de pe Facebook? Acesta ar fi un conținut grozav pentru utilizatorii dvs. de care vor fi interesați. Pentru aceasta, mai întâi, găsiți documentația API pentru Flickr. Este important să treceți prin asta mai întâi dacă aveți probleme cu integrarea API-ului în site-ul dvs.

Acum veți vedea posibilitatea de a solicita formatul dorit. Pentru multe API-uri, veți avea opțiuni precum REST, XML-RPC și SOAP. În acest caz, alegeți REST, care este foarte popular cu site-urile WordPress. Când faceți clic pe aceasta, vi se va prezenta un punct final API REST Flickr.

Ce este REST?

REST este un alt acronim de învățat dacă doriți să aveți conținut dinamic și în continuă schimbare pe site-ul dvs. Cu REST, putem folosi apoi GET, POST și DELETE. Aceasta este pentru orice date de pe Flickr, dar funcționează și pentru Facebook, Google sau Instagram.

Acronimul înseamnă transfer de stat reprezentativ. A fost creat pentru a distribui hypermedia și a apărut pentru prima dată cu Roy Fielding în 2000. Acum puteți avea solicitări HTTP care vor primi date pentru dvs. Solicitările HTTP pot posta date și pe alte site-uri web. API-ul este limbajul pe care îl vorbesc două programe de calculator în timp ce vorbesc între ele și comunică. Înțelegând acest limbaj și cum funcționează, puteți extrage date de pe aproape orice site.

Chei API

Site-urile web nu vor simplifica tragerea de date pentru a le afișa pe site-ul dvs. WordPress. Mai întâi trebuie să-ți faci un cont. După ce aveți contul dvs. pe site, solicitați o cheie API de la aceștia. Asigurați-vă că citiți termenii și condițiile. Există termeni specifici care vor fi diferiți în funcție de site-ul web cu care lucrați. Unele site-uri vor limita numărul de solicitări HTTP GET pe care le puteți face într-un anumit interval de timp.

Poate că sunteți limitat la doar 50 de solicitări GET pentru o anumită zi. Acest lucru vă asigură că serverele nu sunt în mod constant lovite de oameni care doresc să facă cereri de resurse. Puteți crește astfel de limite de multe ori mergând pentru o versiune Pro sau o versiune comercială. Când faceți upgrade, veți avea acces la mai multe solicitări HTTP pe care le utilizați pentru a apela la servere. Acesta va fi folosit de obicei de o companie care trebuie să efectueze multe apeluri și nu s-ar aplica unui utilizator obișnuit care doar încearcă să afișeze informații noi pe site-ul său.

Solicitați permisiunea

Nu veți putea obține întotdeauna permisiunea de a avea o cheie API. Unele site-uri solicită să aplicați și să explicați motivul pentru care doriți accesul la cheie. Companiile nu doresc o sarcină mare asupra resurselor lor decât dacă dezvoltatorul folosește în mod activ apelurile pentru a ajuta la promovarea propriilor produse și servicii. S-ar putea chiar ca o echipă să vă examineze solicitarea. Dacă doriți să vă familiarizați cu tehnologia, solicitați acces de pe un site Flickr unde cerințele sunt scăzute. Acum veți avea cheia și codul împreună cu ea.

Autentificare și API-uri

Apoi, luați în considerare dacă doriți să utilizați API-ul pentru a obține date care necesită autentificare. De exemplu, dacă ar trebui să utilizați un API Facebook sau Instagram care vă oferă posibilitatea de a posta imagini și text, acesta ar trebui să fie autentificat. De ce asta? Ei bine, dacă te gândești la asta, ar trebui să ai un cont pentru a posta pe Facebook în mod normal. Nu puteți posta anonim pe site. În mod similar, dacă o API postează în numele dvs., trebuie să fiți autentificat cu un nume de utilizator și o parolă pentru a intra. Acest lucru vă va identifica, iar conținutul postat va trimite înapoi la dvs. dacă sunt postate lucruri care nu ar trebui să fie.

Multe sisteme vor folosi OAuth pentru autentificare, deoarece protocolul este ușor de utilizat și oferă utilizatorilor o modalitate simplă de a interacționa API-ul cu un site web ca proxy. Informațiile sunt trimise printr-un link securizat, astfel încât identitatea utilizatorului să nu fie dezvăluită. Totuși, nu trebuie să fii întotdeauna autentificat.

Punând totul împreună

Acum avem toate piesele de care avem nevoie pentru a începe să facem apeluri API. În WordPress, accesați Aspect și apoi Widgeturi. Acestea sunt scrise în PHP. Folosind documentația API pe care ați extras-o de pe site, inserați-o pentru a începe să faceți cereri. În cazul utilizării API-ului Flickr, adresa URL ar arăta ca https://flickr.com/services/rest

În cod, dacă vedeți o linie pentru cheia dvs. API, copiați-o din momentul în care ați solicitat-o ​​și ați primit parola și cheia. Când primiți datele înapoi de pe un site, acestea pot fi într-un format HTML, XML, Text sau JSON. Să presupunem că nu sunteți complet familiarizat cu toate aceste formate; asta este bine. Selectați unul cu care veți putea lucra și să îl puteți interpreta mai târziu.

API Wordpress
Fotografie de Harry Parvin

Privind Datele

Odată ce ați terminat de lipit informațiile necesare pentru a obține datele, veți avea nevoie și de un fișier PHP sau un fișier WordPress pentru a citi datele și pentru a afișa informațiile pe ecran. Încă o dată, reveniți la documentația API de pe site pentru compania cu care lucrați. Ar trebui să existe un bloc de cod care va scoate datele într-un format pe care îl puteți citi ca text sau afișa ca imagini pe site-ul dvs. WordPress.

Formatarea datelor

Odată ce vedeți că datele apar pe site-ul dvs., poate părea ciudat. Formatarea este doar fluxul de date brute. Când efectuați un apel API către un site extern, nu există nicio încercare de a-l formata într-un mod care să arate plăcut. Dacă doriți să modelați datele într-un mod astfel încât să arate prezentabil, puteți utiliza un fișier CSS care este direcționat spre lustruirea totul. Dacă întâmpinați probleme la scrierea CSS-ului, puteți găsi exemple online pentru a vă oferi o direcție. Copiați codul în fișierul dvs. CSS, astfel încât site-ul dvs. WordPress să îl poată accesa.

Concluzie

Acesta a fost un scurt tutorial despre cum să integrați un API cu site-ul dvs. WordPress. Subiectul este complex și poate fi dificil chiar și atunci când copiați codul. Înregistrați-vă pe unele site-uri online dacă aveți probleme și nu uitați să reveniți în continuare la Teme superbe pentru mai multe recenzii și tutoriale.