AffiliateWP – REST API Extended

Az REST API Extended az AffiliateWP Pro kiegészítője, amellyel a korábban csak olvasható AffiliateWP REST API teljes CRUD jogosultságot kap.
Ez azt jelenti, hogy az affiliate adatok nemcsak lekérdezhetők, hanem létrehozhatók, módosíthatók és törölhetők is API-n keresztül.

Érintett objektumok:

• affiliates
• referrals
• visits
• payouts
• creatives

Milyen problémát old meg?

Alapértelmezésben az AffiliateWP REST API read-only.
Ez gyorsan falba ütközik, ha:

• külső webshopból szeretnél referralokat létrehozni,
• CRM/ERP rendszerből akarsz affiliátokat kezelni,
• automatizált kifizetési vagy jóváhagyási logikát építenél,
• headless vagy több rendszeres architektúrában dolgozol.

A REST API Extended ezt az egész korlátot megszünteti, és egységes, jogosultságokkal védett API-rétegen keresztül teszi vezérelhetővé az affiliate programot.

Mit kapsz a gyakorlatban?

Teljes CRUD minden fő objektumhoz.

Affiliates

• partner létrehozása külső rendszerből
• státusz, jutalékráta, kifizetési e-mail frissítése
• partner törlése vagy inaktiválása

Referrals

• jutalék rögzítése rendelés vagy esemény után
• státuszváltás (pending → unpaid → paid)
• referral törlése hibás tranzakciónál

Visits

• kattintások naplózása nem WordPress alapú felületről
• saját tracking logika bekötése

Payouts

• kifizetések létrehozása könyvelési vagy payroll rendszerből
• payout státuszok kezelése

Creatives

• bannerek, szöveges kreatívok API-alapú kezelése

REST útvonalstruktúra

Gyűjtemény végpont:

• GET listázás
• POST / PUT létrehozás

/wp-json/affwp/v1/{object}

Egyedi erőforrás:

• GET lekérdezés
• PATCH frissítés
• DELETE törlés

/wp-json/affwp/v1/{object}/{id}

OPTIONS kérés:

• kötelező mezők
• típusok
• validációs szabályok
• engedélyezett metódusok

Ez fejlesztés közben hatalmas segítség, mert nem kell dokumentációból találgatni.

Hitelesítés és jogosultság

A kiegészítő Basic Auth-ot használ API-kulcsokkal.

• Public Key = felhasználónév
• Token = jelszó

A kulcsok WordPress jogosultságokhoz kötöttek.
Ha egy kulcshoz csak olvasási jog tartozik, az API sem enged többet.

Kulcskezelés helye:

• AffiliateWP → Tools → API Keys

Végpontok engedélyezése:

• AffiliateWP → Settings → REST API
• objektumonként kapcsolható

Gyors indulás – tipikus hívások

Lekérdezés:

GET /wp-json/affwp/v1/affiliates

Új affiliate létrehozása:

POST /wp-json/affwp/v1/affiliates
{
 "user_id": 123,
 "status": "active",
 "payment_email": "[email protected]"
}

Referral rögzítése:

POST /wp-json/affwp/v1/referrals
{
 "affiliate_id": 45,
 "amount": "29.00",
 "reference": "ORDER-10045",
 "context": "checkout",
 "status": "pending"
}

Státusz frissítés:

PATCH /wp-json/affwp/v1/referrals/987
{
 "status": "paid"
}

Kötelező mezők felfedezése:

OPTIONS /wp-json/affwp/v1/referrals

Tipikus felhasználási esetek

Külső webshop integráció
Egy nem WordPress alapú bolt a vásárlás után API-n keresztül hozza létre a referralokat.

Több WordPress oldal szinkronja
Affiliate elfogadás az egyik oldalon, automatikus létrehozás egy másikon.

ERP / CRM kapcsolat
Ügyfélstátusz változásnál referral jóváhagyás vagy payout indítás.

Zapier / no-code automatizmus
Űrlap beküldése → affiliate létrehozás
Google Sheets sor → payout generálás

Előnyök

• nincs közvetlen adatbázis-művelet
• nincs egyedi admin felület fejlesztés
• biztonságos, jogosultság-alapú API
• headless és több rendszeres működés
• gyorsabb fejlesztés OPTIONS endpointtal

Kinek ajánlott?

Fejlesztőknek és integrátoroknak
Growth és automation csapatoknak
Headless vagy SaaS környezetben dolgozóknak
No-code / low-code felhasználóknak (Zapier, Make)

Követelmények és telepítés

• aktív AffiliateWP core
• érvényes Pro licenc
• REST API Extended kiegészítő telepítése
• objektumtípusok engedélyezése
• API-kulcs generálása

Jó gyakorlatok

• mindig HTTPS használata
• csak a szükséges végpontok engedélyezése
• minimális jogosultságú API-kulcsok
• tokenek rendszeres rotálása
• OPTIONS hívás használata implementáció előtt

Összegzés

Az AffiliateWP – REST API Extended akkor válik nélkülözhetetlenné, amikor az affiliate programod kilép a WordPress admin határain túl.
Teljes kontrollt ad az adatok felett, tiszta integrációs pontokat biztosít, és lehetővé teszi, hogy az affiliate folyamatok automatizált, skálázható és biztonságos módon működjenek bármilyen rendszerrel összekötve.