A WooCommerce REST API hatékony eszköz, hogy a webáruházadat külső eszközzel könnyedén össze tudd kötni. Ehhez sok esetben csak egy API kulcsot kell generálnod.
Mikor használjuk a REST API-t?
Több esetben használtam legalább 1 ügyfélnél már a REST API-t, de további felhasználási lehetőségei is vannak. Közös jellemzőjük, hogy minddel rengeteg időt, élőerős munkát lehet megspórolni.
Marketing automatizáció:
Salesautopilot összekötéssel oldottunk meg külső műveletekkel automatizált adatmódosításokat. Ezt több ügyfélnél használtam már.
Amazonos rendelések áttöltése:
Egy másik ügyfél Amazonos is árul, és egy WooCommerce-be hozzuk be a Base közbeiktatásával a rendeléseket.
Fulfillment szolgáltatóval való adatszinkronizálás:
A logisztikai partner a REST API-n keresztül kéri le a rendeléseket, és azok bizonyos adatait a rendelések feldolgozása során.
A REST API létrehozás feltétele
A „Beállítások” => „Közvetlen hivatkozások” menüpont alatt emberi szemmel „olvashatónak” kell lennie az URL struktúrának. Pl.:
Tehát ha az alapértelmezett, /?p=123 formátumban vannak az URL-jeid, akkor előbb ezt a beállítást el kell végezned.
API kulcs generálása
Az API kulcsokat (amelyek felhasználókhoz kötődnek!) a WooCommerce => Beállítások => Haladó => REST API menüpont alatt lehet kezelni. Azaz létrehozni, szerkeszteni és törölni.
A „Kulcs hozzáadása” gombra kattintva lehet létrehozni az API kulcsot:
Miután az elnevezés, a felhasználó és a jogosultság be lett állítva, az „API-kulcs generálása” gombra kell kattintani. Utána ez a következő képernyő:
Az itt látható adatokat érdemes elmenteni, mert utólag itt nem fognak megjelenni (igaz, adatbázisból kiolvasható). A QR kód is ezeket az információkat tartalmazza, ezért érdemes lementeni, hogy később kéznél legyenek.
Az innen kinyert adatokat – a felhasználói kulcsot és felhasználói titkos kulcsot – kell megadni az összekötendő szoftver felületén, és a külső eszköz máris fog tudni kommunikálni a webáruházzal.
A kulcs visszavonása funkcióval lehet törölni az API-kulcsot, ha az összeköttetést szeretnénk megszűntetni.
Alap REST API lekérdezések
A valami.hu/wp-json/wc/v3/orders nem működik! Kell hozzá a két kulcs. Két példa:
Összes rendelés lekérdezése:
valami.hu/wp-json/wc/v3/orders?consumer_key=xxxx&consumer_secret=xxxx
A 202-es ID-jú rendelés lekérdezése:
valami.hu/wp-json/wc/v3/orders/202?consumer_key=xxxx&consumer_secret=xxxx
Egy példa, a 202-es rendelés ilyen módú lekérésére a böngésző ezt adja visssza:
Külső szoftverrel való összekötés esetén a megfelelő adatok kerülnek kiolvasásra, illetve visszafelé is a megfelelő értékek kerülnek módosításra (pl.: rendelési állapot).
Régi REST API engedélyezése
A WooCommerce Legacy REST API bővítménnyel [letöltés: aktuális verzió | tesztelt verzió] a régebbi WooCommerce-ben már megszokott REST API funkcionalitást is vissza lehet hozni (WooCommerce => Beállítások => Haladó => Legacy API [Elavult API] alatt), ami a HPOS-sal (High-Performance Order Storage) nem kompatibilis.
