API pre e-maily

Správa odosielaných e-mailov — získanie, vytvorenie, odoslanie a odstránenie

Základná URL

https://{tenant}.logzi.com/api/email/

Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, v prípade chyby result.code == 0.

GET /api/email/get

Získanie jednej e-mailovej správy na základe identifikátora.

Query parametre

ParameterTypPovinnéPopis
idintIdentifikátor e-mailovej správy

Príklad požiadavky

GET /api/email/get?id=55
X-API-KEY: {vas_api_kluc}
GET /api/email/clone

Získanie kópie existujúceho e-mailu (šablóna pripravená na nové odoslanie).

Query parametre

ParameterTypPovinnéPopis
idintIdentifikátor e-mailu, ktorý sa má skopírovať

Príklad požiadavky

GET /api/email/clone?id=55
X-API-KEY: {vas_api_kluc}
GET /api/email/list

Získanie stránkovateľného zoznamu e-mailov s možnosťou filtrovania.

Query parametre

ParameterTypPovinnéPopis
list_offsetintPosun stránkovania (predvolene: 0)
list_condition[company_user_id]intFilter podľa identifikátora odosielajúceho pracovníka

Príklad požiadavky

GET /api/email/list?list_offset=0
X-API-KEY: {vas_api_kluc}
GET /api/email/list_receipt

Získanie zoznamu e-mailov odoslaných k danému dokladu.

Query parametre

ParameterTypPovinnéPopis
list_condition[receipt_id]intIdentifikátor dokladu
list_condition[company_user_id]intFilter podľa odosielajúceho pracovníka

Príklad požiadavky

GET /api/email/list_receipt?list_condition[receipt_id]=123
X-API-KEY: {vas_api_kluc}
POST /api/email/save

Vytvorenie alebo úprava e-mailovej správy. Pre nový e-mail data[id] = 0.

POST polia — objekt data

PoleTypPovinnéPopis
idint0 = nový e-mail, >0 = úprava
company_user_idintIdentifikátor odosielajúceho pracovníka
email_subjectstringPredmet e-mailu
email_recepientstringE-mailová adresa príjemcu
email_message_rawstringTelo textu e-mailu
email_message_idintIdentifikátor e-mailovej šablóny
email_directory_idintIdentifikátor priečinka
email_status_idintIdentifikátor stavu
email_ticket_idintIdentifikátor súvisiaceho tiketu

Príklad požiadavky

POST /api/email/save
X-API-KEY: {vas_api_kluc}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_user_id": 3,
    "email_subject": "Számla melléklet",
    "email_recepient": "ugyfel@pelda.hu",
    "email_message_raw": "Kedves Ügyfelünk, mellékeljük a számlát."
  }
}
POST /api/email/delete

Odstránenie e-mailovej správy na základe identifikátora.

POST polia — objekt data

PoleTypPovinnéPopis
idintIdentifikátor e-mailu, ktorý sa má odstrániť

Príklad požiadavky

POST /api/email/delete
X-API-KEY: {vas_api_kluc}
Content-Type: application/json

{ "data": { "id": 55 } }
GET /api/email/send_queue

Okamžité odoslanie e-mailovej správy z odosielacieho frontu. Na základe identifikátora odošle čakajúcu správu.

Query parametre

ParameterTypPovinnéPopis
idintIdentifikátor e-mailu, ktorý sa má odoslať

Príklad požiadavky

GET /api/email/send_queue?id=55
X-API-KEY: {vas_api_kluc}

Kontaktuj nás

Zaujíma ťa náš softvér? Pokojne nám napíš!

Potrebuješ pomoc?

Ak nevieš nájsť odpoveď a potrebuješ pomoc

Zaregistruj sa teraz,
zaplať neskôr!

Vyskúšaj 3 dni zadarmo, bez rizika a záväzkov!