ვები საკმაოდ გაიზარდა ბოლო ათწლეულის განმავლობაში და WordPress ოდნავ ჩამორჩა. უფრო და უფრო მეტი აპლიკაცია შემოდის ქსელში JavaScript-ით და უფრო და უფრო დინამიური ვებსაიტები შენდება ენებით, როგორიცაა Python და Ruby.

WordPres-ის ძირითადი დეველოპერები და WordPress-ის რამდენიმე პროფესიონალი დეველოპერიც კი ფიქრობენ. რომ WordPress-ის დიდი დამოკიდებულება PHP-ზე და JavaScript-ის მინიმალური გამოყენება ზედმეტად მოძველებულია. ეს არის ის, რასაც WordPress REST API მიზნად ისახავს გადაჭრას.

ეს არ ნიშნავს, რომ WordPress შორდება PHP-ს, მაგრამ ეს ნიშნავს, რომ დეველოპერებმა უნდა განიხილონ JavaScript-ის სწავლა, თუ მათ სურთ ისარგებლონ ამ API-ით. შესთავაზოს.

რა არის WordPress REST API?

REST API არ არის ახალი კონცეფცია. სინამდვილეში, როი ფილდინგმა განსაზღვრა ტერმინი „წარმომადგენლობითი სახელმწიფოს გადაცემა“ 2000 წელს, როდესაც მან გამოიყენა იგი HTTP 1.1 და ერთიანი რესურსის იდენტიფიკატორების შესაქმნელად, უფრო ცნობილი როგორც „URI“.

თქვენ ალბათ უკვე იცით, რომ API არის პროგრამული აპლიკაციების სტრუქტურა, რომელიც შეიცავს ინსტრუმენტებისა და პროტოკოლების კომპლექტს, რომელსაც დეველოპერებს შეუძლიათ გამოიყენონ ამ აპლიკაციების შესაქმნელად. REST API მსგავსია, გარდა იმისა, რომ ის ასრულებს თავის მოთხოვნებს და იღებს პასუხებს HTTP პროტოკოლის მეშვეობით.

რეგულარული API, როგორც წესი, იყენებს PHP, Python და Ruby აპლიკაციების შესაქმნელად. თქვენ შეგიძლიათ გამოიყენოთ სხვა ენები, მაგრამ ეს არის ყველაზე პოპულარული. REST API-ების მეშვეობითმარტივი ვებსაიტები და ბლოგები.

JavaScript-ის სწავლა ახლა მთავარი პრიორიტეტი უნდა იყოს, როგორც უკვე აღვნიშნეთ, რადგან ეს არის ენა, რომელსაც WordPress-ის შემქმნელებს სურთ, რომ დეველოპერებმა უფრო ხშირად ჩართონ WordPress პროექტებში.

თქვენ ასევე უნდა გაიაროთ WordPress REST API სახელმძღვანელო, რათა უკეთ გაიგოთ WordPress-ის შეხედულება REST API-ზე. Using the REST API განყოფილება შეიცავს სახელმძღვანელოებს იმის შესახებ, თუ როგორ გამოიყენოთ გლობალური პარამეტრები, პაგინაცია, ჩაშენება და დაკავშირება და ავტორიზაცია, რაც ამ API-ს ძირითადი ცნებებია.

როდესაც თქვენ ყველაფერი საკმაოდ კარგად გესმით. ამის შესახებ, შეგიძლიათ გაიაროთ REST API განყოფილების გაფართოება, რათა გაიგოთ, თუ როგორ გააფართოვოთ API სიღრმისეულად. თქვენ შეიტყობთ მეტი მორგებული საბოლოო წერტილების დამატების შესახებ და ასევე შეისწავლით თუ როგორ გამოიყენოთ მორგებული კონტენტის ტიპები და შეცვალოთ პასუხები.

WordPress REST API

მე უკვე ავხსენი, თუ როგორ არის WordPress REST API უფრო მეტად WordPress-ის მიახლოების შესახებ. სადაც არის დანარჩენი ვები და ნაკლებია PHP-ს დაშორება. საქმე ეხება დეველოპერებს ისეთი ენების გამოყენებას, როგორიცაა JSON და JavaScript, რათა WordPress-ი გახდეს სრულფასოვანი პლატფორმა, რომელსაც შეუძლია გამოიყენოს ბევრად მეტი, ვიდრე ტრადიციული ვებსაიტები და ბლოგები.

აქ არის WordPress-ის განმარტება JSON-ის ჩართვის შესახებ. WordPress REST API-ში:

WordPress REST API უზრუნველყოფს API ბოლო წერტილებს WordPress-ის მონაცემთა ტიპებისთვის, რომლებიც დეველოპერებს საშუალებას აძლევს საიტებთან დისტანციურად დაუკავშირდნენ JSON (JavaScript Object Notation) ობიექტების გაგზავნით და მიღებით. JSON არის ღია სტანდარტის მონაცემთა ფორმატი, რომელიც არის მსუბუქი და ადამიანისთვის წასაკითხი და ჰგავს Objects-ს JavaScript-ში; აქედან მოდის სახელი. როდესაც თქვენ აგზავნით კონტენტს ან მიმართავთ მოთხოვნას API-ზე, პასუხი დაბრუნდება JSON-ში. ეს საშუალებას აძლევს დეველოპერებს შექმნან, წაიკითხონ და განაახლონ WordPress კონტენტი კლიენტის მხარეს JavaScript-დან ან გარე აპლიკაციებიდან, თუნდაც ის, ვინც დაწერილია PHP-ს მიღმა ენებზე.

არსებითად შექმნილია PHP WordPress-ის ბირთვს შორის არსებული უფსკრული გადასალახად. ჩაშენებულია და JavaScript-ზე, რომელსაც მრავალი ვებ აპლიკაცია იყენებს დღეს. WordPress REST API-ის ინფრასტრუქტურა დაემატა WordPress ბირთვსვერსიაში 4.4 (კოდური სახელი „Clifford“) 2015 წლის დეკემბერში. იმ დროს გჭირდებოდათ დანამატი REST API-ის გამოსაყენებლად. თუმცა, ამ API-ს დანარჩენი ნაწილი, კონტენტის ბოლო წერტილები უფრო ზუსტად, დაემატა WordPress-ის ბირთვს 4.7 ვერსიაში (კოდური სახელი „Vaughan“) 2016 წლის დეკემბერში, რაც უარყოფს WP REST API მოდულის საჭიროებას.

როგორ. WordPress REST API მუშაობს

იმისთვის, რომ გაიგოთ, როგორ მუშაობს WordPress REST API, თქვენ უნდა გესმოდეთ, როგორ მუშაობს HTTP მოთხოვნები და პასუხები. ბრაუზერის მისამართის ზოლში URL-ის შეყვანისას, ეს არის მოთხოვნა. როდესაც სერვერი აჩვენებს ვებსაიტს ან აპლიკაციას ამ URL-ისთვის, ეს არის პასუხი.

თქვენ ნახავთ რამდენიმე სხვადასხვა ტიპის მოთხოვნას ან „HTTP მეთოდებს“, როდესაც დაიწყებთ WordPress REST API-ს გამოყენებას. აქ მოცემულია HTTP მეთოდების ოთხი ძირითადი ტიპი, რომელსაც ვებ იყენებს:

• GET – გამოიყენება სერვერიდან მონაცემების მისაღებად
• POST – გამოიყენება სერვერზე მონაცემების გასაგზავნად
• PUT – გამოიყენება სერვერზე მონაცემების შესაცვლელად ან განახლებისთვის
• DELETE – გამოიყენება მონაცემების წასაშლელად სერვერი

იმ მარტივი განმარტებების გათვალისწინებით, ბრაუზერში URL-ის შეყვანა არის GET მოთხოვნა. ვებსაიტზე თქვენი შესვლის ინფორმაციის შეყვანა არის POST მოთხოვნა. თქვენი მიმდინარე პაროლის ახლით შეცვლა არის PUT მოთხოვნა, ხოლო თქვენი ანგარიშის შეწყვეტა არის DELETE მოთხოვნა.

დამატებითი პირობები, რომლებსაც შეამჩნევთ, არის „მარშრუტები“ და „ბოლო წერტილები“. მარშრუტი, როგორც წესი, არის URL ანURL-ის ნაწილი, რომელზეც ცდილობთ წვდომას, ხოლო საბოლოო წერტილი, როგორც წესი, არის პასუხი, რომელსაც იღებთ სერვერისგან.

როდესაც გარე წყაროები უგზავნიან HTTP მოთხოვნებს თქვენს WordPress საიტის მასპინძელ სერვერზე, REST API გამოაქვეყნებს თქვენს მონაცემებს. უსაფრთხოდ, ამ მოთხოვნებზე პასუხის გაცემით საერთო არქიტექტურით და საკუთარი პროტოკოლებით.

ეს საშუალებას აძლევს WordPress-ის კონტენტს, როგორიცაა პოსტები, გვერდები და კომენტარები, დამუშავდეს როგორც ნედლი მონაცემები. ამას ერთ წუთში მივიღებთ. ამის საერთო მიზანია საშუალებას მოგცემთ შეიტანოთ ცვლილებები თქვენი საიტის შინაარსში WordPress-ის ადმინისტრაციულ ზონაში წვდომის გარეშე. ასე შეგიძლიათ შეიტანოთ ცვლილებები თქვენს საიტზე JSON-ის გამოყენებით, რომლის პასუხები დეველოპერებს საიტებთან ინტერაქციის უამრავ გზას აძლევს.

მოდით, ცოტა დავიბინძუროთ, რომ ნახოთ, როგორ მუშაობს ეს ყველაფერი.

WordPress REST API-ს გამოყენება

ჩვენ განვიხილავთ, თუ როგორ გამოვიყენოთ WordPress REST API, მაგრამ სამწუხაროდ, არის რამდენიმე ძირითადი კონცეფცია, რომლებიც ჯერ უნდა გადავიდეთ ასე რომ, ეს ყველაფერი აზრიანია. აქ არის ძირითადი ცნებები, რომლებიც ქმნიან ამ API-ს:

• მარშრუტები და amp; საბოლოო წერტილები
• მოთხოვნები
• პასუხები
• სქემა
• კონტროლერის კლასები

მოდით, მივიღოთ.

მარშრუტები & amp; საბოლოო წერტილები

მარშრუტის ტექნიკური განმარტება არის URL, რომელიც შეიძლება განისაზღვროს სხვადასხვა HTTP მეთოდით. მარშრუტსა და HTTP მეთოდს შორის რუქას ეწოდება an"ბოლო წერტილი." თქვენ შეგიძლიათ შეხვიდეთ WordPress REST API-ზე და ნახოთ რომელი მარშრუტები და ბოლო წერტილები ხელმისაწვდომია თქვენი საიტისთვის მარშრუტის “/wp-json/”-ის დამატებით თქვენი URL-ის ბოლოს.

ეს შეგიძლიათ ნახოთ WordPress.org-ზე. ეწვიეთ //www.wordpress.org/wp-json/:

დააინსტალირეთ გაფართოება სახელწოდებით JSON Viewer Chrome-ისთვის (JSON viewer Firefox-ისთვის ხელმისაწვდომია აქ) ამ არევის გასასუფთავებლად:

თუ არ იყენებთ ლამაზ პერმალინკებს, გამოიყენეთ „?rest_route=“ ნაცვლად „wp-json“. ნებისმიერ შემთხვევაში, რასაც ხედავთ აქ არის მარშრუტისა და საბოლოო წერტილის მაგალითი. „/wp-json/“ და „/?rest_route=/“ არის მარშრუტები. ისინი საშუალებას გაძლევთ შეხვიდეთ WordPress REST API-ზე GET HTTP მეთოდით. თქვენზე ნაჩვენები WordPress REST API, ან მონაცემები, თუ გსურთ, არის საბოლოო წერტილი, რომელიც ჩვენთვის მოწოდებულია JSON პასუხის საშუალებით.

მოთხოვნები

WordPress REST API ამუშავებს მოთხოვნებს კლასთან სახელად WP_REST_Request. . ეს არის პირველადი კლასი WordPress REST API ინფრასტრუქტურაში. ის გამოიყენება თქვენს მიერ გაკეთებული ყველა მოთხოვნისთვის ინფორმაციის შესანახად და მოსაპოვებლად.

შეგიძლიათ დისტანციურად გაგზავნოთ მოთხოვნები HTTP მეთოდების გამოყენებით, რომლებიც ჩვენ განვიხილეთ, ან შეგიძლიათ გააკეთოთ ისინი შინაგანად, როგორც ამას ჩვეულებრივ აკეთებთ PHP-ის საშუალებით.

4>პასუხები

პასუხები მუშავდება WP_REST_Response კლასით. პასუხი არის მონაცემები, რომელსაც იღებთ მოთხოვნიდან, როგორც ეს ადრე იყო ნათქვამი. API იყენებს ამ კლასს ბოლო წერტილებიდან გაგზავნილი მონაცემების დასაბრუნებლად. ის ასევე შეიძლება დაბრუნდესშეცდომები.

Schema

Schema არის კონცეფცია WordPress REST API-ში, რომელიც ემსახურება სხვადასხვა მიზნებს. API სქემა განსაზღვრავს მონაცემთა სტრუქტურებს, რომლებსაც შეუძლიათ გამოიყენონ ბოლო წერტილები და ის შეიცავს იმ თვისებების ჩამონათვალს, რომლებსაც WordPress REST API-ს შეუძლია დააბრუნოს. ის ასევე შეიცავს პარამეტრებს, რომლებსაც API შეუძლია მიიღოს და უზრუნველყოფს მის უსაფრთხოებას API-ს მიერ მიღებული მოთხოვნების ვალიდაციის გზით.

კონტროლერის კლასები

WordPress REST API აღრიცხავს მარშრუტებს და ბოლო წერტილებს, ამუშავებს მოთხოვნებს, იყენებს სქემას. განსაზღვროს მონაცემები და თვისებები, რომელსაც შეუძლია გამოიყენოს და აგენერირებს API პასუხებს ყოველივე ამის თავზე. API-ს და თქვენ, როგორც დეველოპერს, გჭირდებათ გზა, რომ მართოთ ყველა ეს მოძრავი ნაწილი. სწორედ ამისთვის არის კონტროლერის კლასები. ისინი საშუალებას გაძლევთ შეაგროვოთ ყველა ეს ელემენტი და მოაწყოთ ისინი ერთ ადგილას.

WordPress REST API-ის გამოყენება თქვენს კონტენტზე წვდომისთვის ბოლო წერტილების მეშვეობით

მარშრუტი არის URL, რომელსაც იყენებთ წვდომისთვის საბოლოო წერტილი და საბოლოო წერტილი არის პასუხი, რომელსაც იღებთ სერვერისგან. თუ გსურთ მიიღოთ თქვენი საიტის პოსტები WordPress REST API-ით, გამოიყენეთ მარშრუტი „/wp/v2/posts/“. WordPress განმარტავს, რომ "/wp-json/" არ შედის ამ გრძელ მარშრუტებში, რადგან ეს არის "საბაზისო გზა თავად API-სთვის". დასასრული URL არის “example.com/wp-json/wp/v2/posts”.

თუ გსურთ კონკრეტულ პოსტზე წვდომა API-ის საშუალებით, უბრალოდ დაამატეთ პოსტის ID-ის მისამართი URL-ის ბოლოს. ეს ასე გამოიყურება:„example.com/wp-json/wp/v2/posts/123“

თუ გსურთ მოძებნოთ პოსტები, რომლებიც იყენებენ კონკრეტულ ფრაზას ან საკვანძო სიტყვას, გამოიყენეთ ეს მარშრუტი: „/wp/v2/posts? =ძებნა[ ჩადეთ საკვანძო სიტყვა აქ ]“ ასე რომ URL ასე გამოიყურება: „example.com/wp-json/wp/v2/posts?search[ ჩადეთ საკვანძო სიტყვა აქ ].

თუ გსურთ კონკრეტული მომხმარებლის პროფილზე წვდომა API-ის საშუალებით, დაამატეთ „/users/“ მარშრუტზე, ისევე როგორც ამ მომხმარებლის მომხმარებლის ID. URL ასე გამოიყურება: “example.com/wp-json/wp/v2/users/2”. ანალოგიურად, თუ გსურთ საიტის მომხმარებლებზე წვდომა, ჩამოაგდეთ ID, რათა URL ასე გამოიყურებოდეს: “example.com/wp-json/wp/v2/users/”.

აქ შეგიძლიათ ნახოთ მეტი საბოლოო წერტილი .

REST API-ის გაფართოება

ჩვენ გამოვტოვებთ რამდენიმე საფეხურს და ვისწავლით თუ როგორ გამოვიყენოთ REST API-ის თვისებები მის გასავრცელებლად. თქვენ უნდა გაეცნოთ გლობალურ პარამეტრებს, პაგინაციას, დაკავშირებას და ჩაშენებას და ავთენტიფიკაციას, სანამ ამას გააკეთებთ, მაგრამ ჩვენ ვაპირებთ გამოტოვებას ამ სწრაფი დაწყების სახელმძღვანელოს მიზნებისთვის.

აქ არის რამოდენიმე რამ, რისი გაკეთებაც შეგიძლიათ. შეასრულეთ REST API-ის გაფართოებით:

• დაამატეთ მორგებული საბოლოო წერტილები
• შექმენით მარშრუტები პირადი პოსტების ტიპებისთვის და მორგებული ტაქსონომიებისთვის
• პასუხების შეცვლა

თუ გამოცდილი დეველოპერი ხართ, სავარაუდოდ უკვე იცნობთ REST API-ში მორგებული საბოლოო წერტილის დასამატებლად საჭირო ცნებებს. უბრალოდ ისწავლეთ როგორ დააკავშიროთ ეს ორი.

თქვენ დაიწყებთ ფუნქციის შექმნითეს შეიძლება იყოს მარტივი ან რთული, იმისდა მიხედვით, თუ რა დახვეწილობის ფუნქციები ცდილობთ დაამატოთ REST API-ში. ეს არის მარტივი ფუნქცია, რომელსაც WordPress უზრუნველყოფს თავის სახელმძღვანელოში, ფუნქცია, რომელიც შექმნილია ავტორის მიერ თქვენი საიტის უახლესი პოსტების სათაურების მოსაპოვებლად:

 $data['id'], ) ); if ( empty( $posts ) ) { return null; } return $posts[0]->post_title; } 

ამის შემდეგ, თქვენ უნდა დაარეგისტრიროთ მარშრუტი, რომ ეს ფუნქცია ხელმისაწვდომი გახადოთ API სხვა ფუნქციის გამოყენებით, სახელწოდებით register_rest_route. ეს არის ფუნქცია, რომელსაც WordPress იყენებს წინა ფუნქციის მარშრუტის დასარეგისტრირებლად:

 'GET', 'callback' => 'my_awesome_func', ) ); } );

აქ რამდენიმე რამ ხდება. პირველი, არის სამი თვისება, რომელიც გადის ამ ფუნქციას. ეს არის სახელთა სივრცე (“myplugin/v1”), მარშრუტი, რომელიც უნდა დარეგისტრირდეთ (“my_wesome_func”) და ოფციები, რომელთა გამოყენებაც გვინდა (“author/(?P\d+)”). Register_rest_route ფუნქცია ასევე გამოიძახება გამოძახების ფუნქციაზე სახელწოდებით "rest_api_init". ეს ამცირებს არასაჭირო სამუშაოს რაოდენობას, რომელიც შესრულებულია, როდესაც API არ გამოიყენება.

როგორც WordPress განმარტავს, ეს მარშრუტი შექმნილია იმისთვის, რომ შეესაბამებოდეს რაიმე „/author/{id}“-ს, სადაც „{id }” არის მთელი რიცხვი. ეს არის URL, რომელსაც ეწვევით ამ მარშრუტის გამოსაყენებლად – //example.com/wp-json/myplugin/v1/author/(?P\d+) . ეს კონკრეტული მარშრუტი იყენებს ერთ ბოლო წერტილს, მაგრამ მარშრუტებს შეუძლიათ ჰქონდეთ მრავალი საბოლოო წერტილი. თქვენ ხედავთ, რომ ჩვენ ასევე განვსაზღვრეთ HTTP მეთოდი, რომელსაც გამოიყენებდა ეს ბოლო წერტილი.

სხვა ცნებები დაგჭირდებათ

არსებობს რამდენიმედამატებითი ცნებები, რომლებიც უნდა ისწავლოთ, თუ გსურთ REST API-ის გაფართოება, იმ პირობით, რომ მათ უკვე არ იცნობთ. ჩვენ გამოვიყენეთ სახელთა სივრცე ზემოთ მოცემულ ფუნქციაში, რის გამოც ზემოთ მოცემული URL-ის პირველი ნაწილი არის „myplugin/v1“. ისინი გამოიყენება როგორც პრეფიქსები, რათა თავიდან იქნას აცილებული შეჯახება მორგებულ მარშრუტებთან.

არგუმენტები არის კიდევ ერთი კონცეფცია, რომელიც უნდა იცოდეთ, რადგან ისინი საშუალებას გაძლევთ განახორციელოთ სანიტარული და ვალიდაცია მარშრუტების რეგისტრაციისას მათი დარეგისტრირებით. თქვენ ასევე უნდა გაეცნოთ დაბრუნების მნიშვნელობებს, რადგან ეს არის ის, რასაც გამოიყენებთ სერვერისგან პასუხის ტიპის დასადგენად. თქვენ შეგიძლიათ გამოიყენოთ ისინი შეცდომების დასაბრუნებლად, როგორიცაა 404 შეცდომა, რომელიც გამოჩნდება, თუ ავტორს არ აქვს გამოქვეყნებული პოსტები.

გამოძახება არის კიდევ ერთი კონცეფცია, რომელიც უნდა იცოდეთ, როგორიცაა ფუნქციები, რომლებიც ცნობილია როგორც ნებართვების გამოძახება, რომელიც ამოწმებს თუ არა ან არა მომხმარებელს შეუძლია შეასრულოს მოქმედება მანამ, სანამ ფუნქცია შეეცდება ფაქტობრივი გამოძახების გამოძახებას. დაბოლოს, შიდა კლასებისა და კონტროლერების შაბლონების გაცნობა დაგეხმარებათ მართოთ თქვენ მიერ შექმნილი საბოლოო წერტილების ყველა ასპექტი.

საბოლოო აზრები და amp; სად წავიდეთ აქედან

WordPress REST API-ის ძირითადი ცნებების გაგება და მისი გამოყენებისა და გაფართოების სწავლა შეიძლება იყოს ძალიან დიდი, მაგრამ WordPress-ის შემქმნელები საკმაოდ დარწმუნებულნი არიან, რომ ეს იქნება CMS-ის ძალა. ის უნდა გაიზარდოს ბევრად აღემატება მის შესაძლებლობებს, როგორც პლატფორმის ასაშენებლად