Newsman API Page - Newsman

Newsman – Knowledge Base

HomeNewsman API Page

Sectiuni

List

Draft

Segment

Subscriber

Template

Download

Import

Abtest

Listare API Newsman

Metoda API	Metoda HTTP	Endpoint	Descriere
List
list.getProps	GET	/list.getProps.json	Returnează un array (cheie / valoare) cu propietățile unei liste
list.updateProps	POST	/list.updateProps.json	Actualizează proprietățile unei liste
list.updateProp	POST	/list.updateProp.json	Actualizează o proprietate a unei liste
list.getProp	GET	/list.getProp.json	Returnează o proprietate a unei liste
list.all	GET	/list.all.json	Returnează un array cheie / valoarea cu toate listele
list.count	GET	/list.count.json	Returnează numărul de abonați activi dintr-o listă
list.updateName	POST	/list.updateName.json	Actualizează numele unei liste
list.getModerators	GET	/list.getModerators.json	Returnează un array cu moderatorii unei liste
list.setModerators	POST	/list.setModerators.json	Actualizează moderatorii unei liste
list.getIps	GET	/list.getIps.json	Returnează un array cu ip-urile unei liste (un ip per element de array)
list.getSubscribers	GET	/list.getSubscribers.json	Returnează, pentru o listă, abonații cu un anumit status sau inscriși în listă de la un anumit timp (opțional)
list.getSubscriberVariables	GET	/list.getSubscriberVariables.json	Returnează variabilele custom ale unei liste
list.refreshSubscriberVariables	POST	/list.refreshSubscriberVariables.json	Actualizează variabilele custom ale unei liste
list.subscribersHistory	GET	/list.subscribersHistory.json	Returnează un array cu istoricul abonaților unei liste
list.anonymiseSubscriber	POST	/list.anonymiseSubscriber.json	Șterge un abonat dintr-o listă
Newsletter
Metoda API	Metoda HTTP	Endpoint	Descriere
newsletter.getProps	GET	/newsletter.getProps.json	Returnează un array (cheie / valoare) cu propietățile unui newsletter
newsletter.getProp	GET	/newsletter.getProp.json	Returnează o proprietate a unui newsletter
newsletter.updateProps	POST	/newsletter.updateProps.json	Actualizează proprietățile unui newsletter
newsletter.updateProp	POST	/newsletter.updateProp.json	Actualizează o proprietate a unui newsletter
newsletter.pause	POST	/newsletter.pause.json	Pune pauză trimiterii unui newsletter
newsletter.resume	POST	/newsletter.resume.json	Repornește un newsletter pus pe pauză
newsletter.schedule	POST	/newsletter.schedule.json	Programează un newsletter să se trimită în viitor
newsletter.cancel	POST	/newsletter.cancel.json	Anulează un newsletter
newsletter.confirm	POST	/newsletter.confirm.json	Confirmă un newsletter prin API
newsletter.sendConfirm	POST	/newsletter.sendConfirm.json	Trimite un mail de confirmare
newsletter.create	POST	/newsletter.create.json	Creează un newsletter în această listă
newsletter.getSegments	GET	/newsletter.getSegments.json	Returnează un array (cheie / valoare) cu segmentele unui newsletter
newsletter.setSegments	POST	/newsletter.setSegments.json	Actualizează segmentele unui newsletter
newsletter.setAlternateContent	GET	/newsletter.setAlternateContent.json	Seteaza conținutul alternativ pentru n newsletter (vizibil online la ##NEWSMAN:view_online##?akey=)
newsletter.all	GET	/newsletter.all.json	Returnează o listă cu newslettere având status $status între $start_date, $stop_date (inclusiv)
newsletter.update	POST	/newsletter.update.json	Actualizează un newsletter în această listă (doar neconfirmat)
newsletter.sendTest	POST	/newsletter.sendTest.json	Trimite un test la mailurile specificate
newsletter.stats	GET	/newsletter.stats.json	Returnează statisticile pentru un newsletter
newsletter.linksClicked	GET	/newsletter.linksClicked.json	Returnează link-urile pe care s-a dat click dintr-un newsletter
newsletter.restart	POST	/newsletter.restart.json	Repornește un newsletter oprit / trimis
newsletter.subscribersHistory	GET	/newsletter.subscribersHistory.json	Returnează un array cu istoricul abonaților unei newsletter
Draft
Metoda API	Metoda HTTP	Endpoint	Descriere
draft.getDraftInfo	GET	/draft.getDraftInfo.json	Returnează un array (cheie / valoare) cu informațiile unui draft
Segment
Metoda API	Metoda HTTP	Endpoint	Descriere
segment.all	GET	/segment.all.json	Returnează un array cheie / valoarea cu toate segmentele dintr-o listă
segment.search	GET	/segment.search.json	Returnează un array cheie / valoarea conținând segmentele unei liste care se potrivesc unui regex
segment.count	GET	/segment.count.json	Returnează numărul de abonați activi dintr-un segment
segment.updateName	POST	/segment.updateName.json	Actualizează numele unei segment
segment.delete	POST	/segment.delete.json	Șterge un segment
segment.addSubscriber	POST	/segment.addSubscriber.json	Adaugă un abonat la un segment
segment.removeSubscriber	POST	/segment.removeSubscriber.json	Scoate un abonat dintr-un segment
segment.create	POST	/segment.create.json	Creaază un nou segment într-o listă
segment.clear	POST	/segment.clear.json	Scoate toți abonații dintr-un segment
segment.refresh	POST	/segment.refresh.json	Pornește o actualizare a segmentului
segment.getSubscribers	GET	/segment.getSubscribers.json	Returnează abonații dintr-un segment
segment.massUnsubscribe	POST	/segment.massUnsubscribe.json	Dezabonează toți abonații dintr-un segment
segment.massDeactivate	POST	/segment.massDeactivate.json	Dezactivează toți abonații dintr-un segment
Subscriber
Metoda API	Metoda HTTP	Endpoint	Descriere
subscriber.get	GET	/subscriber.get.json	Returnează informații despre abonat ca array cheie / valoare
subscriber.getByEmail	GET	/subscriber.getByEmail.json	Returnează informații despre abonat ca array cheie / valoare
subscriber.history	GET	/subscriber.history.json	Returnează istoricul acțiunilor unui abonat (ultimele 30 acțiuni) într-un array
subscriber.update	POST	/subscriber.update.json	Actualizează email, firstname, lastname pentru un abonat
subscriber.updateProps	POST	/subscriber.updateProps.json	Actualizează proprietățile unei abonat
subscriber.updateProp	POST	/subscriber.updateProp.json	Actualizează o proprietate a unei abonat
subscriber.addToSegment	POST	/subscriber.addToSegment.json	Adaugă un abonat la un segment
subscriber.removeFromSegment	POST	/subscriber.removeFromSegment.json	Scoate un abonat dintr-un segment
subscriber.saveSubscribe	POST	/subscriber.saveSubscribe.json	Salvează / abonează un abonat la o listă
subscriber.initSubscribe	POST	/subscriber.initSubscribe.json	Inițiază o cerere de abonare confirmed opt-in. Este trimis mai întâi un email conținând un link unic pe care trebuie dat click.
subscriber.saveUnsubscribe	POST	/subscriber.saveUnsubscribe.json	Dezabonează un email dintr-o listă
subscriber.initUnsubscribe	POST	/subscriber.initUnsubscribe.json	Inițiază o cerere de dezabonare. Un email conținând un link pentru dezabonare va fi trimis abonatului
subscriber.getProfilingAllowed	GET	/subscriber.getProfilingAllowed.json	Returnează dacă este permisă profilarea unui abonat
subscriber.setProfilingAllowed	POST	/subscriber.setProfilingAllowed.json	Setează dacă este permisă profilarea unui abonat
subscriber.search	GET	/subscriber.search.json	Returnează abonații dintr-o listă care se potrivesc unor cuvinte cheie, status și data abonării (opțional)
Template
Metoda API	Metoda HTTP	Endpoint	Descriere
template.mailTemplateAdd	POST	/template.mailTemplateAdd.json	Adaugã un template de mailuri tranzacționale pentru această listă. Poate fi folosit ulterior în initSubscribe și initUnsubscribe.
template.mailTemplateDel	POST	/template.mailTemplateDel.json	Șterge un template de mail
template.mailTemplateUpdate	POST	/template.mailTemplateUpdate.json	Actualizează un template de mail tranzacțional pentru această listă
template.mailTemplateGet	GET	/template.mailTemplateGet.json	Returnează conținutul unui template ca array cheie / valoare
template.mailTemplateSearch	GET	/template.mailTemplateSearch.json	Returnează un array cu id-uri de template-uri pentru această listă și acest tip
Download
Metoda API	Metoda HTTP	Endpoint	Descriere
download.subscribed	GET	/download.subscribed.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la ip-ul curent, conținând utilizatorii abonați a unei liste.
download.unsubscribed	GET	/download.unsubscribed.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la ip-ul curent, conținând utilizatorii dezabonați (prin link click) a unei liste.
download.unsubscribed_all	GET	/download.unsubscribed_all.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la ip-ul curent, conținând utilizatorii dezabonați a unei liste, indiferent de metoda dezabonării.
download.bounced	GET	/download.bounced.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la ip-ul curent, conținând utilizatorii bounced a unei liste.
download.reported_spam	GET	/download.reported_spam.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la ip-ul curent, conținând utilizatorii care au raportat spam.
download.segment	GET	/download.segment.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la ip-ul curent, conținând utilizatorii unui segment.
download.search	GET	/download.search.json	Returnează un link de download către un fișier CSV conținând utilizatorii care se potrivesc unui criteriu de căutare.
download.newsletterSent	GET	/download.newsletterSent.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la IP-ul curent, conținând utilizatorii care au primit acest newsletter.
download.newsletterViewed	GET	/download.newsletterViewed.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la IP-ul curent, conținând utilizatorii care au vizualizat acest newsletter.
download.newsletterClicked	GET	/download.newsletterClicked.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la IP-ul curent, conținând utilizatorii care au dat click pe acest newsletter.
download.newsletterUnsubscribes	GET	/download.newsletterUnsubscribes.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la IP-ul curent, conținând utilizatorii care s-au dezabonat de la newsletter.
download.newsletterReportedSpam	GET	/download.newsletterReportedSpam.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la IP-ul curent, conținând utilizatorii care au raportat ca spam acest newsletter.
download.newsletterBounced	GET	/download.newsletterBounced.json	Returnează un link de download către un fișier CSV, valid pentru o oră, de la IP-ul curent, conținând utilizatorii care au avut bounce la acest newsletter.
Import
Metoda API	Metoda HTTP	Endpoint	Descriere
import.csv	POST	/import.csv.json	Creează un task care importa useri dintr-un fișier csv (data în $csv_data) în baza de date. Importul va rula în background.
import.schedulecsv	POST	/import.schedulecsv.json	Creează un task care importa useri dintr-un fișier csv (data în $csv_data) în baza de date, după un anumit timp. Importul va rula în background.
import.status	GET	/import.status.json	Returnează status-ul unui import după ID.
Abtest
Metoda API	Metoda HTTP	Endpoint	Descriere
abtest.createVariant	POST	/abtest.createVariant.json	Creează o variantă a unui newsletter (parte din AB Test)
abtest.setTestProps	POST	/abtest.setTestProps.json	Actualizează proprietățile unui AB Test
abtest.getTestProps	GET	/abtest.getTestProps.json	Returnează proprietățile unui AB Test
abtest.getVariantsIds	GET	/abtest.getVariantsIds.json	Returnează un array cu id-urile variantelor
abtest.getVariant	GET	/abtest.getVariant.json	Returnează o anumită variantă a unui AB test
abtest.deleteVariant	POST	/abtest.deleteVariant.json	Șterge o variantă a unui test
abtest.setWinner	POST	/abtest.setWinner.json	Setează câștigătorul unui AB test