WordPress REST API: Bu nədir və istifadə etməyə necə başlamaq lazımdır

Son bir neçə il ərzində WordPress cəmiyyətində hər hansı bir vaxt keçirmisinizsə, yeni REST API-ə istinad şansınız var. Təcrübəli bir geliştirici olsanız, WordPress REST API-nin əslində nə olduğu barədə heç bir təsəvvürünüz olmaya bilər.


Texniki detallar bir az mürəkkəb olsa da, bu xüsusiyyətin arxasında duran əsas anlayışlar başa düşmək üçün asandır. Yeni API bir platforma olaraq nə edə biləcəyini WordPress’i genişləndirməyə kömək edir. Bundan əlavə, REST API, inkişaf etdiricilərin WordPress-i digər sayt və tətbiqlərlə bağlamasını həmişəkindən daha asan edir.

WordPress REST API

Bu hərtərəfli bələdçinizdə sizə lazım olan bütün əsasları araşdıracağıq. Ümumiyyətlə API-lərin nə olduğunu və REST API-lərin (və WordPress-in xüsusi versiyası) nə olduğunu izah edəcəyik. Sonra WordPress REST API-ni özünüzdən necə istifadə etməyiniz barədə danışacağıq. Gəlin içəri tullanaq!

Tətbiq Proqramlaşdırma İnterfeyslərinə (API) giriş

Xüsusi olaraq REST API-i nəzərdən keçirməzdən əvvəl, bir az ehtiyatlı olaq. Bu konsepsiyanı başa düşmək üçün əvvəlcə API-lərin nə olduğu barədə əsas təsəvvürün olması vacibdir.

Ən fundamental səviyyədədir, bir API – və ya tətbiqi proqram interfeysi – iki tətbiqin bir-biri ilə əlaqə qurmasına imkan verir. Məsələn, bir veb saytı ziyarət edərkən brauzeriniz həmin saytın yerləşdiyi serverə sorğu göndərir. Bu serverin API brauzerinizin sorğusunu qəbul edən, şərh edən və saytınızı göstərmək üçün tələb olunan bütün məlumatları göndərən şeydir.

Daha çox şey var API-lərin işləmə yolu əlbəttə ki, texniki mənada. Bununla birlikdə, ən çox sizin üçün ən vacib olan şeylərə – praktik tətbiqlərə diqqət yetirəcəyik. Bir çox şirkət onları istifadə edə biləcəyiniz məhsul kimi təqdim etməyə başladığına görə API-lər çox diqqət və görünmə əldə edir..

Başqa sözlə, Google kimi bir şirkətin inkişaf etdiriciləri tətbiq kodlarının bəzi hissələrini birlikdə toplayacaq və onu ictimaiyyətə təqdim etmək. Bu yolla, digər inkişaf etdiricilər API-lərini öz saytlarının Google-a qoşulmasına və onun xüsusiyyətlərindən yararlanmaq üçün bir vasitə kimi istifadə edə bilərlər:

Google API-lər kitabxanası.

Məsələn, Google Maps API-dən istifadə edə bilərsiniz tam işləyən xəritə yerləşdirin Google’un bütün aidiyyəti məlumatlarından və xüsusiyyətlərindən faydalanan saytınızda. Bu, bir xəritə kodlamaq və bütün bu məlumatları özünüz toplamaqdan xilas edir. Eyni şey geniş sayt və tətbiqlərə aiddir.

Veb saytları və etibar etdikləri funksionallıq daha mürəkkəbləşdikcə, API kimi alətlər vacib olur. İnkişaf etdiricilərə mövcud funksionallıq üzərində qurulmağa imkan verir və veb saytınıza yeni funksiyaların qoşulmasına imkan verir. Öz növbəsində, API sahibi olan sayt artan məruz qalma və trafikdən faydalanır.

Bir REST (Nümayəndəlik Dövlət Transfer) API’nin əsas qaydaları

API yaratmaq üçün bir çox yol var. A REST (Nümayəndəlik Dövlət Transferi) API xüsusi qaydalara əsasən inkişaf etdirilən xüsusi bir növüdür. Başqa sözlə, REST, API qurarkən istifadəçilərin istifadə edə biləcəyi bir sıra təlimatları təqdim edir. Bu, API-lərin effektiv işləməsini təmin edir.

REST API-lərin necə işlədiyini başa düşmək üçün onların hansı qaydalar (və ya ‘məhdudiyyətlər) altında işlədiyini bilmək lazımdır. Var beş əsas element API ‘RESTful’ edən. Unutmayın ki, ‘server’, API’nin olduğu platformadır və ‘müştəri’ həmin platformaya qoşulan sayt, tətbiq və ya proqramdır:

TƏCİLİ

  1. Müştəri-server arxitekturası. Müştəri və server bir-birindən ayrı qalması üçün API qurulmalıdır. Bu yolla onlar özləri inkişaf etməyə davam edə bilər və müstəqil olaraq istifadə edilə bilər.
  2. Vətəndaşlıqsızlıq. REST API’ləri ‘vətəndaşlığı olmayan’ bir protokola əməl etməlidir. Başqa sözlə, müştəri haqqında heç bir məlumatı serverdə saxlaya bilmirlər. Müştərinin tələbi bütün zəruri məlumatları daxil etməlidir və cavab müştərinin ehtiyacı olan hər şeyi təmin etməlidir. Bu, hər bir qarşılıqlı əlaqəni ‘bir və tamamlanmış’ sövdələşmə halına gətirir və həm yaddaş tələblərini, həm də səhvlər üçün potensialı azaldır.
  3. Cacheability. A ‘önbellek’ xüsusi məlumatların müvəqqəti saxlanmasıdır, buna görə daha sürətli alınaraq göndərilə bilər. RESTful APIlər sürət və səmərəliliyi artırmaq üçün mümkün olduqda önbelleğe alınan məlumatlardan istifadə edir. Əlavə olaraq, API, hər bir məlumat parçasının yaddaşda saxlanıla biləcəyini və ya edilməyəcəyini müştəriyə bildirməlidir.
  4. Laylı sistem. Yaxşı dizayn edilmiş REST API-lər, hər biri öz təyinatlılığı ilə istifadə olunan təbəqələrdən istifadə etməklə qurulur. Bu təbəqələr qarşılıqlı olur, lakin ayrı qalır. Bu, vaxt keçdikcə API-nin dəyişdirilməsini və yenilənməsini asanlaşdırır təhlükəsizliyini artırır.
  5. Vahid interfeys. Bir REST API-nin bütün hissələri eyni interfeys vasitəsilə işləməli və eyni dillərdən istifadə edərək ünsiyyət qurmalıdır. Bu interfeys xüsusi olaraq API üçün hazırlanmalı və öz-özünə inkişaf edə bilməlidir. Bu işləmək üçün serverdən və ya müştəridən asılı olmamalıdır.

Bu prinsiplərə əməl edən hər hansı bir API RESTful hesab edilə bilər. “Tələb kodu” deyilən bir altıncı məhdudiyyət də var. Bu üsul təqib edildikdə, API, funksionallığını genişləndirmək üçün serverə bir müştəriyə kod ötürməyi tapşırır. Lakin, bu məhdudiyyət isteğe bağlıdır və bütün REST API-ləri tərəfindən qəbul edilmir.

WordPress REST API

Bu anda, bütün bunların sizə necə təsir etdiyini düşünə bilərsiniz. API əla vasitələrdir, ancaq gündəlik işinizə uyğundurmu? Bir WordPress istifadəçisisinizsə, cavab birmənalı deyil "bəli".

WordPress REST API artıq bir neçə ildir ki inkişafdadır. Bir müddətdir ki, üzərində işlənib müstəqil bir plugin, zamanla inkişaf etdirə bilən hansısa bir şəxsin sınaqdan keçirməsi üçün əlçatandır.

Əslində var idi iki ayrı versiya REST API plagininin. API elementləri əsas platformaya 4.4 yeniləməsindən əvvəl əlavə edildi. Bunun ardınca WordPress 4.7 (2016-cı ildə) olaraq tam inteqrasiya olundu. Bu o deməkdir ki, bu gün WordPress-də özünün tam işləyən REST API var.

Niyə platforma bu hərəkəti etdi? Görə layihə saytı özü, WordPress-in bir olmağa doğru getdiyi üçün "tam hüquqlu bir tətbiq çərçivəsi". Başqa sözlə, REST API platforma yalnız hər hansı bir sayt və veb tətbiq ilə qarşılıqlı əlaqə qurmağa imkan verir. Üstəlik, xarici bir proqramın hansı dillərdən istifadə etməsindən asılı olmayaraq əlaqə qura və məlumat mübadiləsi edə bilər.

istirahət api

Bu, tərtibatçılar üçün çoxsaylı imkanlar açır. Həm də WordPress-i həmişəkindən daha çevik və universal bir platforma halına gətirir. Katie Keith olaraq, Əməliyyatlar direktoru Barn2 Media qoyur:

REST API-ni başa düşməklə, WordPress tərtibatçıları, PHP və ya WordPress kimi son texnologiya və ya platforma ilə məhdudlaşmadan, hər tapşırığı həyata keçirməyin ən təsirli yolunu seçə bilərlər. Səmərəli istifadə edilərkən, REST API üçüncü tərəflərin inteqrasiyasını daha da asanlaşdırır … Hətta yeni imkanlar açır, məsələn, öz WordPress əsaslı mobil tətbiqlərinizi yaratmaq və ya WordPress ilə ünsiyyət üçün yeni və bənzərsiz yolları araşdırmaq.

Bəzən WordPress JSON REST API adlandırılan bu xüsusiyyəti eşidə biləcəyinizi də nəzərə almaq lazımdır. ‘JSON’ hissəsi, JavaScript Object Notation üçün dayanan bu API məlumat mübadiləsi üçün istifadə etdiyi formatı təsvir edir. Bu format JavaScript-ə əsaslanır və bir çox ümumi proqramlaşdırma dilləri ilə nə qədər yaxşı əlaqə qurmaları sayəsində API-lərin inkişaf etdirilməsinin məşhur bir yoludur. Başqa sözlə, bir JSON API fərqli dillərdən istifadə edən tətbiqlər arasındakı rabitəni daha da asanlaşdıra bilir.

Bir WordPress REST API tələbinin anatomiyası

İndi WordPress REST API-nin ümumi məqsədini və istiqamətini başa düşməlisiniz. Bu səbəbdən, necə işlədiyinə dair bir neçə spesifikaya nəzər salaq. Əl-ələ verib API ilə özünüzü sınamağa başlamaq istəsəniz başa düşməli olduğunuz bəzi əsas anlayışlar var.

Açıqladığımız kimi, hər bir API sorğu hazırlayır və cavabları qaytarır. Başqa sözlə, bir müştəri müəyyən bir hərəkət etməsini xahiş edir və API bu hərəkəti həyata keçirir. Məhz API-lərin bunu necə dəyişə bilər. REST API-ləri sadə HTML əmrlərindən (və ya ‘metodlar’) istifadə etməklə xüsusi növ tələblərin qəbulu və cavablandırılması üçün hazırlanmışdır..

Təsəvvür etmək üçün burada ən çox şey var əsas və vacib HTML metodları müştəri göndərə bilər:

HTML metodları

  • GET: Bu əmr bir mənbəni serverdən (məsələn, müəyyən bir məlumat parçası) çıxarır.
  • POST: Bununla müştəri serverə bir resurs əlavə edir.
  • QOY: Bunu artıq serverdə olan bir mənbəni redaktə etmək və ya yeniləmək üçün istifadə edə bilərsiniz.
  • YERİNƏ: Adından göründüyü kimi, bu bir serveri bir resursdan silir.

Bu əmrlərlə yanaşı, müştəri hansı mənbənin istədiyi və onunla nə edilməli olduğu barədə tam məlumat verən bir və ya daha çox sətir göndərəcəkdir. Məsələn, bir PHP faylını serverdəki müəyyən bir qovluğa yükləmək istəyi bu kimi görünə bilər:

POST / qovluq adı /my_file.php

/Foldername/my_file.php hissəsidir ‘marşrut’ adlanır, API’ə hara getmək lazım olduğunu və nə ilə əlaqə quracağını söylədiyindən. HTTP metodu ilə birləşdirdiyiniz zaman (bu vəziyyətdə POST), bütün funksiyaya ‘son nöqtə’ deyilir.

REST API-lərinin çoxu və onlarla əlaqə quran müştərilər bundan daha mürəkkəb olurlar – WordPress versiyası. Bununla birlikdə, bu əsas elementlər WordPress REST API-nin necə işlədiyini zəmin təşkil edir.

WordPress REST API istifadə etməyə necə başlamaq olar

Bir WordPress saytı qurduğunuz müddətdə dərhal REST API ilə sınağa başlaya bilərsiniz. Brauzerinizdən istifadə edərək birbaşa məlumat əldə etmək üçün müxtəlif GET tələblərini yerinə yetirə bilərsiniz.

WordPress REST API-ə daxil olmaq üçün aşağıdakı marşrutla başlamaq lazımdır.

sizinite.com/wp-json/wp/v2

Sonra, müxtəlif məlumatlara daxil olmaq üçün bu URL üzərinə əlavə edə bilərsiniz. Məsələn, bu kimi bir marşrut vasitəsilə müəyyən bir istifadəçi profilinə baxa bilərsiniz:

sizinite.com/wp-json/wp/v2/users/4567

Bu ssenaridə, "4567" görmək istədiyiniz profil üçün unikal istifadəçi identifikatorudur. Bu şəxsiyyət sənədini tərk etsəniz, saytınızdakı bütün istifadəçilərin siyahısını görmək istərdiniz:

WordPress REST API istifadəçilərinin siyahısı.

Yazılarınız və ya səhifələriniz kimi digər məlumat növlərini görmək üçün eyni əsas marşrutdan istifadə edə bilərsiniz. Hətta müəyyən kriteriyalara cavab verən məlumatların alt hissələrini axtara bilərsiniz. Məsələn, bu URL istifadə edərək müəyyən bir müddət olan bütün yazıları əldə edə bilərsiniz:

sizinite.com/wp-json/wp/v2/posts?=sahifəni açar söz]

Əlbətdə bu sadəcə sadə bir illüstrasiyadır. Həqiqətən WordPress REST API istifadə edərək edə biləcəyiniz şey üçün heç bir məhdudiyyət yoxdur. Bunun necə işlədiyini daha çox öyrənmək istəyirsinizsə, aşağıdakı mənbələrdən başlamağı məsləhət görürük:

WordPress REST API şübhəsiz mürəkkəb bir mövzudur. Hətta inkişaf etdirməyənlər üçün də bu texnologiyanın necə işlədiyinin əsaslarını və nəyin mümkün olduğunu başa düşmək dəyər. Bundan əlavə, özünüzü inkişaf etdirməyə başlamağınıza da imkan yarada bilər!

WordPress REST API istifadə edərkən daha bir yanaşma

WordPress REST API bir sıra maraqlı şeylər və layihələr üçün istifadə edilə bilər. Bunu olduqca aydın şəkildə qurduq.

Həqiqi populyarlıq qazanan bir sahə var:

Başsız WordPress WordPress ekosisteminin iki əsas təbəqəsini – arxa və ön hissəni ayırmaq fikri.

Bu, WordPress proqramının kapotun altındakı bütün yaxşılıqları götürməyə və standart WordPress təqdimatından istifadə etməyən son məhsulla əlaqələndirməyə imkan verir – bu veb sayt deyil..

Bütün konsepsiya çox maraqlıdır. Bu barədə başqa bir yazıda daha çox danışırıq, burada başsız WordPress-in mənasız olub-olmadığını müzakirə edirik və bazarda ən yaxşı başsız WordPress hosting həllərini müqayisə edirik.

Nəticə

WordPress REST API haqqında indidən daha yaxşı öyrənmək üçün daha yaxşı vaxt yoxdur. Tamamilə WordPress nüvəsinə birləşdirildiyi üçün platformanın gələcəyində mühüm rol oynayacaqdır. Bütün zolaqları hazırlayanlar əvvəllər çətin və ya qeyri-mümkün olan yollarla WordPress-i daha geniş şəbəkəyə bağlamaq üçün bu API-dən istifadə edəcəklər.

Özünüz üçün bu konsepsiyanı başa düşmək bir az çətin ola bilər. Əsas səviyyədə, konsepsiyalar başa düşmək üçün kifayət qədər asandır. Bir REST API, iki proqramın bir-birinə “danışmasına” imkan verən və yaradılan bir interfeysdir aşağıdakı qaydalar elastik, genişlənən və etibarlı olmasını təmin edir. Bütün bunların necə işlədiyini və necə istifadə olunacağını daha dərindən öyrənmək istəyirsinizsə, orada rəsmi kimi çox sayda faydalı mənbələr var əl kitabı.

REST API ilə bağlı hər hansı bir sualınız varmı və bu WordPress üçün nə deməkdir? Aşağıdakı şərh bölməsində bizdən soruşun!

WordPress saytınızı sürətləndirmək üçün qəza kursumuza qoşulmağı unutmayın. Bəzi sadə düzəlişlərlə yükləmə müddətinizi hətta 50-80% azalda bilərsiniz:

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map