2017-12-04 13:26:31 +01:00
|
|
|
ninjaMail API
|
2017-12-04 13:05:23 +01:00
|
|
|
===============
|
2017-12-04 13:31:35 +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
|
2017-12-04 13:31:35 +01:00
|
|
|
CURL könyvtárral vagy más, GET és POST hívást támogató eszközzel.
|
|
|
|
|
|
|
|
|
2017-12-04 13:26:31 +01:00
|
|
|
## 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
|
2017-12-04 13:31:35 +01:00
|
|
|
között feliratkozók hozzáadására, törlésére.
|
|
|
|
|
|
|
|
|
2017-12-04 13:26:31 +01:00
|
|
|
## API URL
|
2017-12-04 13:31:35 +01:00
|
|
|
Az URL kulcsgenerálás után ugyan azon a felületen lesz látható.
|
2017-12-04 13:31:55 +01:00
|
|
|
`Példa: http://example.org/a/<gyár>?key=<kulcs>
|
2017-12-04 13:31:35 +01:00
|
|
|
Ahol: ^ ^ ^ API Kulcs
|
|
|
|
^ Részegység
|
2017-12-04 13:31:55 +01:00
|
|
|
Szolgáltató címe.`
|
2017-12-04 13:31:35 +01:00
|
|
|
|
|
|
|
|
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
|
2017-12-04 13:31:35 +01:00
|
|
|
látható. A feliratkozást végző gyár: subscribe
|
|
|
|
A kérés a következőképpen alakul:
|
|
|
|
`POST: http://example.org/a/subscribe?key=<kulcs>`
|
2017-12-04 13:41:03 +01:00
|
|
|
`DATA: list=<id>&name=<Feliratkozó neve>&email=<Feliratkozó E-mail>&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,
|
2017-12-04 13:34:43 +01:00
|
|
|
míg 0 állásban küld megerősítő hivatkozást a megadott címre.
|
|
|
|
|
|
|
|
#### Várható válaszok
|
|
|
|
Sikeres feliratkozás: `success`, Sikertelen feliratkozás: `sub_error`,
|
|
|
|
Rossz lista azonosító: `bad_list`, Sikertelen regisztráció: `reg_error`
|
2018-02-14 11:46:20 +01:00
|
|
|
|
|
|
|
|
|
|
|
### Feliratkozó eltávolítása listáról
|
|
|
|
Feliratkozó eltávolításához szükségünk van a lista azonosítójára és a feliratkozó
|
|
|
|
e-mail címére.
|
|
|
|
A kérés a következőképpen alakul:
|
|
|
|
`POST: http://example.org/a/unsubscribe?key=<kulcs>`
|
|
|
|
`DATA: list=<id>&email=<Feliratkozó E-mail>`
|
|
|
|
|
|
|
|
#### Várható válaszok
|
|
|
|
Sikeres leiratkozás: `success`, Sikertelen leiratkozás: `unsub_error`,
|
|
|
|
Ismeretlen E-mail cím: `unknown_email`, Hiányzó paraméterek: `missing_parameters`
|