WooCommerce REST API tərtibatçılara HTTP sorğuları vasitəsilə məhsullar, sifarişlər və müştərilər kimi mağaza məlumatlarını oxumaq və yazmaq imkanı verən son nöqtələr dəstidir. API ilə qarşılıqlı əlaqədə olaraq siz mağaza idarəetmə tapşırıqlarını avtomatlaşdıra, üçüncü tərəf tətbiqlərini inteqrasiya edə və ya xüsusi idarəetmə panelləri yarada bilərsiniz. Bu yanaşma standart WordPress idarəetmə panelinin sərhədlərindən kənara çıxaraq inventarınız və istifadəçi məlumatlarınız üzərində proqramlaşdırıla bilən nəzarəti təmin edir. Bu, fərdi əlaqələr quran tərtibatçılar üçün standart alətdir.
WooCommerce REST API nədir?
WooCommerce REST API onlayn mağazanız ilə xarici tətbiqlər arasında körpü rolunu oynayır. O, tərtibatçılara əsas məlumat obyektləri üzərində CRUD (Yaratmaq, Oxumaq, Yeniləmək, Silmək) əməliyyatlarını yerinə yetirməyə imkan verir. Məsələn, xarici anbar idarəetmə sistemindən məhsul ehtiyatlarının səviyyəsini birbaşa mağazanıza sinxronizasiya etmək üçün skрыпt yaza bilərsiniz. API HTTP üzərindən işləyir, yəni bu resursları idarə etmək üçün GET, POST, PUT və DELETE kimi standart üsullardan istifadə edir. O, WordPress REST API infrastrukturu üzərində qurulub ki, bu da onun əsas mühitlə uyğun qalmasını təmin edir.
Məlumat mübadiləsi üçün JSON-dan istifadə etdiyinə görə, o, Python, JavaScript, PHP və Ruby də daxil olmaqla demək olar ki, istənilən müasir proqramlaşdırma dili ilə uyğundur. Bu rahatlıq bizneslərə canlı məlumatları çəkən xüsusi mobil tətbiqlər, daxili hesabat alətləri və ya avtomatlaşdırılmış müştəri dəstəyi botları yaratmağa imkan verir. API-dən istifadə etməklə minlərlə məhsulu yeniləməli olduğunuz hər dəfə CSV fayllarını əllə ixrac etmək və idxal etmək ehtiyacını aradan qaldırırsınız. Bu, biznesinizin istifadə edə biləcəyi müxtəlif platformalarda məlumatların ardıcıllığını qorumaq üçün etibarlı üsuldur.
WooCommerce-də API girişini necə quraşdıra bilərsiniz?
API-dən istifadə etməyə başlamaq üçün əvvəlcə WordPress idarəetmə panelinizdə etimadnamələr yaratmalısınız. WooCommerce menyusuna keçin, sonra Parametrlərə klikləyin. Oradan Qabaqcıl vərəqini seçin və REST API linkinə klikləyin. Yeni giriş nişanı yaratmaq üçün “Açar əlavə et” üzərinə klikləməlisiniz. Bu proses zamanı siz təsvir, istifadəçi və icazə səviyyəsini təyin etməlisiniz: Oxumaq, Yazmaq və ya Oxumaq/Yazmaq. Sistem bundan sonra sizə İstehlakçı Açarını və İstehlakçı Məxfiliyini təqdim edəcək.
Seçdiyiniz icazələrə əsasən mağaza məlumatlarınıza tam girişi təmin etdikləri üçün bu açarları təhlükəsiz şəkildə saxlamaq vacibdir. Bu açarları heç vaxt ümumi anbarlarda və ya istifadəçilərə görünən müştəri tərəfi kodunda paylaşmayın. Əgər ön tərəf tətbiqi qurursunuzsa, sorğularınızı etibarlı server tərəfi skripti vasitəsilə yönləndirdiyinizə əmin olun. Bu açarları yaratdıqdan sonra açarı və məxfiliyi HTTP başlıqlarınızda parametr kimi və ya URL sorğu sətirinin bir hissəsi kimi ötürməklə sorğularınızı təsdiqləyə bilərsiniz.
API sorğuları üçün hansı üsullar mövcuddur?
API avtomatlaşdırma iş axınınızda hər biri xüsusi məqsədə xidmət edən dörd əsas sorğu üsulunu dəstəkləyir. Siz üsulu mövcud məlumatları əldə etdiyinizə və ya serverə yeni məlumat göndərdiyinizə əsasən seçməlisiniz. Standart HTTP təcrübələrinə əməl etmək sorğularınızın WordPress serveri tərəfindən düzgün işlənməsini təmin edir. Bu üsulları başa düşmək mağaza məzmununu əllə insan müdaxiləsi olmadan dəyişdirən skript qurmaqda ilk addımdır.
- GET: Serverdən bütün məhsulların siyahısının və ya müəyyən sifarişin təfərrüatlarının əldə edilməsi kimi məlumatları əldə edir.
- POST: Yeni məhsulun əlavə edilməsi və ya yeni müştəri hesabının qeydiyyatdan keçirilməsi kimi yeni resurs yaradır.
- PUT: Məhsul qiymətlərini dəyişdirmək, ehtiyat səviyyələrini yeniləmək və ya müştərinin çatdırılma ünvanlarını dəyişdirmək üçün tez-tez istifadə olunan mövcud məlumatları yeniləyir.
- DELETE: Köhnə məhsul siyahısının və ya müəyyən sifariş girişinin həmişəlik silinməsi kimi mağazanızdan resursu silir.
API İdarəetmə Metodlarının Müqayisəsi
| Əməliyyat Növü | HTTP Metodu | Əsas İstifadə Halı |
|---|---|---|
| Oxumaq | GET | Hesabatların yaradılması və ya məhsulların göstərilməsi |
| Yaratmaq | POST | Yeni inventarın və ya müştəri qeydiyyatlarının əlavə edilməsi |
| Yeniləmək | PUT | İnventar səviyyələrinin və ya qiymət dəyişikliklərinin sinxronizasiyası |
| Silmək | DELETE | İstehsalı dayandırılmış malların çıxarılması |
Alien Road WooCommerce REST API-ni necə tətbiq edir
Alien Road olaraq biz müştərilərə e-ticarət mağazaları ilə əməliyyat proqramları arasındakı boşluğu aradan qaldırmağa kömək etmək üçün WooCommerce REST API-dən istifadə edirik. Tipik bir hesabda biz WooCommerce üçün yerli plaginə malik olmayan xarici inventar idarəetmə sistemindən istifadə edən müştəri ilə qarşılaşa bilərik. Xarici sistemdə ehtiyat dəyişikliyi baş verdikdə işə düşən xüsusi skript yaradırıq. Bu skript daha sonra həddindən artıq satışın qarşısını almaq üçün real vaxt rejimində məhsul inventarını yeniləmək üçün WooCommerce API-yə PUT sorğusu göndərir.
Biz həmçinin hesabat tapşırıqları üçün API-dən istifadə edirik. Məlumatları WordPress admin panelindən əllə ixrac etmək əvəzinə, hər günün sonunda sifariş məlumatlarını çəkən avtomatlaşdırılmış boru kəmərləri qururuq. Bu məlumat təhlükəsiz verilənlər bazasına daxil edilir və komandamıza canlı vebs-saytda lazımsız yük qoymadan müştəri üçün xüsusi idarəetmə panelləri yaratmağa imkan verir. Bu, vitrinin sürətli qalmasını təmin edərkən, biznes sahibinə ehtiyat və marketinq strategiyaları haqqında məlumatlı qərarlar qəbul etmək üçün lazımi məlumatları alır.
API istifadə edərkən ümumi səhvlər
- Məhdudiyyətlərə məhəl qoymamaq: WooCommerce müəyyən zaman çərçivəsində edə biləcəyiniz sorğuların sayını məhdudlaşdıra bilər, ona görə də 429 status kodları üçün səhvlərin idarə edilməsini həyata keçirin.
- Sərtkodlaşdırma Etimadnamələri: İstehlakçı açarınızı və sirrinizi birbaşa mənbə kodunda saxlamaq kod sızarsa, təhlükəsizlik boşluqlarına səbəb olur.
- SSL Tələblərinə məhəl qoymamaq: API ötürülən məlumatların şifrələnmiş və ələ keçirilmədən təhlükəsiz qalmasını təmin etmək üçün HTTPS vasitəsilə təhlükəsiz bağlantı tələb edir.
- Məlumatların Təsdiqlənməməsi: Verilənlər bazanızda deformasiya olunmuş məhsulların və ya pozulmuş sifariş girişlərinin yaranmasının qarşısını almaq üçün həmişə API-yə göndərdiyiniz məlumatları təsdiqləyin.
API autentifikasiyasını necə idarə edirsiniz?
Autentifikasiya təhlükəsiz əlaqənin təməlidir. Tətbiqiniz sorğu göndərərkən yaratdığınız İstehlakçı Açarını və İstehlakçı Məxfiliyini təqdim etməlidir. Siz adətən bunları “Əsas Autentifikasiya” vasitəsilə və ya URL sorğu parametrlərinə daxil etməklə ötürürsünüz. Əgər PHP-də cURL və ya Python-da ‘requests’ kimi kitabxanalardan istifadə edirsinizsə, bu alətlər funksiya zənglərinizdə birbaşa autentifikasiya növünü təyin etməyə imkan verməklə prosesi asanlaşdırır. Server mühitinizin bu HTTP zəngləri üçün lazım olan uzantıları dəstəklədiyini həmişə yoxlayın.
API zənglərinizi sınayırsınızsa, Postman və ya Insomnia kimi alətlər sorğuları kodunuza köçürməzdən əvvəl hazırlamaq və sazlamaq üçün əladır. Bu alətlər JSON cavabını vizual olaraq yoxlamağa və WooCommerce mağazanız tərəfindən qaytarılan başlıqları yoxlamağa imkan verir. Əvvəlcə səhnələşdirmə mühitində sınaqdan keçirməklə, siz API cavablarının sintaksisini və strukturunu hələ də öyrənərkən təsadüfən canlı məlumatları dəyişdirməkdən və ya silməkdən qaçınırsınız.
Bu həftə haradan başlamaq lazımdır
Heç bir risk olmadan API-ni araşdırmaq üçün mağazanızın səhnələşdirmə versiyasını quraşdırmaqla başlayın. Test açarları dəsti yaradın və Postman kimi alətdən istifadə edərək məhsullarınızı siyahıya almaq üçün sadə GET sorğusunu sınayın. JSON məlumatlarının uğurla qaytarıldığını gördükdən sonra PUT sorğusundan istifadə edərək tək məhsul qiymətini yeniləməyə çalışın. Bu əməli təcrübə sizə ehtiyatların sinxronizasiyasının avtomatlaşdırılması və ya biznesiniz üçün öz xüsusi inteqrasiyalarınızın qurulması kimi daha mürəkkəb tapşırıqları yerinə yetirmək üçün inam verəcək.
Tez-tez Verilən Suallar
WooCommerce REST API istifadə etmək pulsuzdurmu?
Bəli, WooCommerce REST API WooCommerce plugininin quraşdırılmış xüsusiyyətidir və daxil olmaq üçün heç bir əlavə ödəniş və ya abunə tələb etmir. Sizə yalnız WooCommerce plaginləri quraşdırılmış və konfiqurasiya edilmiş işlək WordPress saytınızın olması lazımdır.
Məhsulları digər platformalardan köçürmək üçün API-dən istifadə edə bilərəmi?
Bəli, digər platformadan məhsul idxal etmək üçün API-dən istifadə edə bilərsiniz. Mənbə platformanızdan məlumatları oxuyan və sonra onu WooCommerce məhsul strukturuna uyğunlaşdıran skript yazmalısınız. Xəritə edildikdən sonra skriptiniz hər bir element üçün API-yə POST sorğusu göndərir. Bu, xüsusi xüsusi sahələr və ya mürəkkəb məhsulvariasiyaları tələb edən böyük miqrasiyaları idarə etməyin standart yoludur.
401 İcazəsiz xətası almasam nə etməliyəm?
401 xətası təqdim etdiyiniz autentifikasiya etimadnaməsinin səhv olduğunu və ya çatışmadığını göstərir. İstehlakçı Açarınızın və İstehlakçı Məxfiliyinizin düzgün kopyalandığını və WooCommerce parametrlərinizdə müvafiq icazələri seçdiyinizi iki dəfə yoxlayın. Həmçinin, Əsas Autentifikasiyadan istifadə edirsinizsə, serverinizin başlıqları ötürmək üçün düzgün konfiqurasiya edildiyinə əmin olun, ஏn bəzi server konfiqurasiyaları bu başlıqları silə bilər.
API açarlarımı necə qoruya bilərəm?
Açarlarınızı heç vaxt müştəri tərəfi kodunda və ya GitHub kimi ümumi versiyaya nəzarət sistemlərində ifşa etməməklə onları qorursunuz. Onları yalnız arxa kodunuzun daxil ola biləcəyi serverinizdəki mühit dəyişənlərində saxlayın. Açarlarınızın ələ keçirildiyindən şübhələnirsinizsə, mağaza məlumatlarınızın təhlükəsizliyini qorumaq üçün onları dərhal WooCommerce parametrlərində ləğv etməli və yeni etimadnamələr cütü yaratmalısınız.
Oxumağa davam edin: Elektron ticarət · Elektron ticarət