O privire la API-ul WordPress HTTP O revizuire

Una dintre provocările legate de scrierea unei serii despre un API - sau chiar o parte a unui API - este că este greu să acoperiți fiecare aspect al API-ului menționat, fără a cheltui prea mult timp scufundând adânc într-o parte și încercând simultan să nu deplasați în partea de sus a fiecărui API fără a oferi suficiente informații practice.

Cazul în cauză: În ultima serie, am analizat API-ul WordPress HTTP. Mai exact, am acoperit wp_remote_get și wp_remote_post, și am făcut o activitate relativ extinsă cu ambele funcții, inclusiv proiecte de construcție.

Lucrul este că există încă o mulțime de teren care ar putea fi acoperit în API-ul WordPress HTTP. În viitor, putem face o serie avansată pe mai multe aspecte ale API, dar pentru moment, să analizăm tot ce am acoperit în această serie.


Dar mai întâi, de ce un rezumat?

Scrierea unei serii relativ lungi despre câteva funcții poate acoperi o mulțime de teren. Problema de a face acest lucru este că, în orice moment în viitor, trebuie să vă referiți la o parte, este posibil să nu vă amintiți exact unde a fost localizată informația.

Sau poate, mai rău, este posibil să fiți nevoiți să folosiți o cantitate semnificativă de informații pentru a găsi un aspect de care aveți nevoie pentru a continua să faceți progrese în munca dvs..

Sigur că puteți să vă referiți întotdeauna la indexul seriei, dar pentru a da un fel de "ghid rapid", m-am gândit că ar fi util să rezumăm articolele, funcțiile și notele de nivel înalt privind segmentul API că am acoperit doar în cazul în care aveți nevoie de o referință pentru munca dvs..

Desigur, rețineți că puteți vedea întotdeauna seria în întregime pe pagina de înscrieri în serii.


Solicitări la distanță

Înainte de a examina fiecare funcție, rețineți că o solicitare la distanță poate fi definită ca fiind procesul prin care un server face o cerere către un alt server.

În general, un server poate trimite pur și simplu date către celălalt server care va fi apoi trimis Fă ceva cu ea (fie că salvează datele, procesează datele și așa mai departe) și poate trimite opțional un răspuns înapoi.

La un nivel înalt, asta o solicitare la distanță. Pentru mai multe informații despre această idee, asigurați-vă că ați verificat această postare.


wp_remote_get

wp_remote_get este o funcție care face parte din API-ul WordPress HTTP care este responsabil pentru efectuarea OBȚINE cereri.

Funcția acceptă:

  • O adresă URL la care se face solicitarea
  • Gama de argumente pentru a trimite împreună cu cererea

Dacă sunteți responsabil în primul rând pentru regăsirea informații de la server, atunci aceasta este funcția pe care o veți dori să o utilizați.

În al doilea rând, dacă aveți nevoie de mai mult de o adresă URL sau de mai mult control asupra cererii trimise, atunci puteți examina acest articol pentru a examina toate argumentele pe care le acceptă.

Cum funcționează asta?

În continuare, în serie, am construit un plug-in real care să lege wp_remote_get pentru a putea recupera numărul de adepți pentru un anumit cont Twitter, precum și ultimele tweet-uri trimise din contul Twitter.

Scopul principal al acestui articol și acest demo a fost de a oferi un exemplu practic de utilizare wp_remote_get într-un cadru "real". Pentru codul sursă complet pentru demonstrația de lucru, asigurați-vă că revizuiți articolul asociat.

Ce se întoarce?

pentru că wp_remote_get este axat pe regăsirea informație, are sens doar că ne așteptăm la un răspuns, nu? În articolul final care acoperă wp_remote_get, am analizat exact ce este returnat de pe server și modul în care WordPress îl formatează pentru utilizarea noastră.

Dacă, pe parcursul muncii dvs., aveți un timp dificil pentru a descifra exact ce înseamnă revenirea de pe server (sau de ce nu funcționează așa cum era de așteptat), atunci acesta este articolul pe care ar trebui să-l revedeți.


wp_remote_post

Doar noi wp_remote_get este responsabil pentru a face OBȚINE cereri, wp_remote_post este responsabil pentru a face POST cereri.

Ca și în cazul wp_remote_get, wp_remote_post acceptă aceleași argumente:

  • Adresa URL la care se face solicitarea
  • O serie de argumente care ajută la adaptarea cererii la server

Dar există o diferență fundamentală în scopul acestei funcții și al celei anterioare discutate. Diferența este ceea ce se întâmplă când cererea este finalizată.

Doar noi wp_remote_get este folosit în primul rând pentru a recupera date, wp_remote_post este folosit pentru a trimite datele de pe fir care urmează să fie procesate - un răspuns nu poate fi trimis niciodată înapoi.

Pentru cercetarea inițială a acestei funcții - ceea ce acceptă, inclusiv lista avansată de argumente - revedeți acest articol.

Cum funcționează asta?

La fel ca și noi wp_remote_get, am creat un plugin pentru a demonstra cum wp_remote_post funcționează în contextul mai larg al temei WordPress.

Deși plugin-ul se află pe GitHub pentru referință, vom trece prin întreaga primă versiune a plugin-ului în următorul articol. În mod specific, acoperim modul în care se face cererea unui scenariu responsabil pentru primire $ _POST date și apoi modul în care poate să formateze și să returneze un răspuns apelantului.

Ce se întoarce?

În ultimul articol din seria, am completat plugin-ul folosind mai puțin pentru a oferi pluginului un aspect ușor și mai plăcut și am rotunjit plugin-ul, astfel încât să salveze efectiv unele date de răspuns în baza de date doar pentru a da o idee cu privire la modul în care acest lucru poate fi atins.


Concluzie

Sumarul posturilor este un teritoriu nou - cel puțin pentru mine - așa cum am lăsat în serios seria mea să stea singură, dar m-am gândit că ar fi o referință frumoasă pentru a oferi luând în considerare că am acoperit atât de mult teren în serie.

A reitera:

  • Iată lista completă a articolelor din serie
  • Acesta este un link către wp_remote_get cod sursa
  • Aici este wp_remote_post proiect pe GitHub

Cu asta ați spus, dați-mi voie să știu dacă preferați postări sumare sau nu. Așa cum am menționat, acesta este un lucru pe care nu îl fac în mod obișnuit, dar dacă vă ajută să oferiți un punct de referință pentru voi, atunci sunt fericit să continuăm să le facem pentru viitoarele serii ".

Cod