2017-12-04 13:26:31 +01:00
|
|
|
ninjaMail API
|
2017-12-04 13:05:23 +01:00
|
|
|
===============
|
|
|
|
|
2017-12-04 13:26:31 +01:00
|
|
|
Ebben a fájlban olvashat arról, hogyan használhatja a levelező
|
|
|
|
alkalmazásprogramozási interfészét.
|
|
|
|
A példákban szereplő lekérések PHP programozási szemszögből készültek, viszont
|
|
|
|
felhasználható más nyelven íródott projektekben is, amennyiben az rendelkezik
|
|
|
|
CURL könyvtárral vagy más, GET és POST hívást támogató eszközzel.
|
|
|
|
|
|
|
|
|
|
|
|
## Bevezetés
|
|
|
|
Az API használatához regisztráció után generálni kell egy kulcsot. Ez a
|
|
|
|
Beállítások -> API menüből érhető el. A generált kulcsot tartsa titokban!
|
|
|
|
Míg API kulccsal nem lehet bejelentkezni a webes felületen, az API felületen a
|
|
|
|
legtöbb funkció elérhető. A kulcs felhasználásával lehetőség nyílik többek
|
|
|
|
között feliratkozók hozzáadására, törlésére.
|
|
|
|
|
|
|
|
|
|
|
|
## API URL
|
|
|
|
Az URL kulcsgenerálás után ugyan azon a felületen lesz látható.
|
2017-12-04 13:29:25 +01:00
|
|
|
Példa: http://example.org/a/<gyár>?key=<kulcs>
|
2017-12-04 13:26:31 +01:00
|
|
|
Ahol: ^ ^ ^ API Kulcs
|
|
|
|
^ Részegység
|
2017-12-04 13:29:25 +01:00
|
|
|
Szolgáltató címe.
|
2017-12-04 13:26:31 +01:00
|
|
|
|
|
|
|
|
|
|
|
### Feliratkozó hozzáadása
|
|
|
|
Feliratkozó hozzáadása esetén tudni kell a lista azonosítóját. Ez a webes
|
|
|
|
felületre történő belépés után a Listák menüpontban a kettőskereszt oszlopban
|
|
|
|
látható. A feliratkozást végző gyár: subscribe
|
|
|
|
A kérés a következőképpen alakul:
|
2017-12-04 13:27:34 +01:00
|
|
|
`POST: http://example.org/a/subscribe?key=<kulcs>`
|
|
|
|
`DATA: name=<Feliratkozó neve>&email=<Feliratkozó E-mail címe>&activated=<1|0>`
|
2017-12-04 13:26:31 +01:00
|
|
|
Az activated paraméter 1-es állásban megerősítettként rögzíti a feliratkozót,
|
|
|
|
míg 0 állásban küld megerősítő hivatkozást a megadott címre.
|