- Newsman - Knowledge Base

Posturi etichetate cu ‘api’

[{"type":"import","timestamp":1372428476,"data":{"import_id":"51cd98951fbbbf972d000001","status":"finished"}}] ( */ $newsman_events = json_decode($_POST["newsman_events"]); print_r($newsman_events[0]); /* Array ( [type] => import [timestamp] => 1372428476 [data] => Array ( [import_id] => 51cd98951fbbbf972d000001 [status] => finished ) ) */ ?>

Mai jos puteți vedea ce informație se trimite în funcție de tipul de eveniment:
import: import_id (poate fi citit prin API), status
newsletter_status: newsletter_id, status
unsub: newsletter_id, subject, list_id, abonat_id, email
spam: newsletter_id, subject, list_id, abonat_id, email
bounce: newsletter_id, subject, abonat_id, email, email_head (mesajul intreg al bounce-ului), diag_msg (descriere scurtă a bounce-ului), hard_bounce (daca este de tip HARD)

Postat de admin pe February 15, 2017

Instalarea plugin-ului NewsMAN în WordPress

Plugin-ul NewsMAN pentru WordPress îți permite să adaugi pe site-ul tău un formular de abonare, să sincronizezi abonații și să le trimiți newslettere.

În acest tutorial vă sunt prezentați pașii pentru instalarea și folosirea plugin-ului NewsMAN în platforma WordPress.

Din interfața de administrare a platformei WordPress navigați în secțiunea Plugins – New plugin.
Căutați „Newsmanapp” în formularul de căutare.
Click pe Install Now, iar după ce instalarea a fost efectuată cu succes, click pe Activate.
Generați din contul dumneavoastră NewsMAN API KEY (Secțiunea Integrări > API) și introduceți codul API, USER ID-ul și REMARKETING ID-ul în NewsMAN > Settings (setările plugin-ului NewsMAN din platforma WordPress). Remarketing ID îl veți găsi în meniul din stânga, în secțiunea Integrări > NewsMAN Remarketing:

Pentru a putea folosi formulare / pop-up-uri de abonare sau automatizări ecommerce create în contul NewsMAN, activați NewsMAN Remarketing.

Citiți toate detalii despre plugin-ul NewsMAN în WordPress.

Postat de bogdan pe March 7, 2014

Autentificare OAuth 2.0

Pentru a accesa API-ul newsman folosind autentificare OAuth 2, trebuie sa parcurgeti etapele:

Inregistrarea aplicatiei care va folosi API-ul cu autentificare OAuth2

Folositi formularul de contact si trimiteti-ne urmatoarele date:
– Numele aplicatiei
– redirect_uri: Callback URL unde Newsman va trimite un callback (ex: https://situlmeu.ro/callback)

Noi va punem la dispozitie doi parametri pe care ii veti folosi la autentificare:
– client_id (ex: app_client_example)
– client_secret (ex: 123123123123 )

Autentificarea

API-ul Newsman foloseste pentru autentificare protocolul OAuth 2.0
Toate request-urile catre API trebuie facute folosind SSL (https:// nu http://)

Pentru autentificare aveti nevoie de:
– client_id (vi-l trimitem dupa inregistrarea aplicatiei)
– client_secret (vi-l trimitem dupa inregistrarea aplicatiei)
– Authorization endpoint: https://ssl.newsman.ro/admin/oauth/authorize
– Token endpoint: https://ssl.newsman.ro/admin/oauth/token

Pas 1: Directionati utilizatorul la url-ul de autorizare
https://ssl.newsman.ro/admin/oauth/authorize?scope=api&redirect_uri=https%3A%2F%2Fsitulmeu.ro%2Fcallback&response_type=code&client_id=app_client_example

Daca utilizatorul nu este autentificat in Newsman, va fi redirectionat la formularul de login. Utilizatorul va fi intrebat daca permite aplicatiei accesul la contul lui Newsman.

Pas 2: Redirectare din Newsman catre callback URL
https://situlmeu.ro/callback?code=jksasda4sda5ssd1a1122sdassdas123

Daca utilizatorul nu a permis accesul la contul Newsman, va fi redirectionat la url-ul
https://situlmeu.ro/callback?error=access_denied&error_description=end-user+denied+authorization

Pas 3: Obtineti access_token
In pasul anterior ati obtinut “code”-ul care trebuie schimbat pe un “access_token” (API key).
Pentru a-l schimba, faceti un request POST la access_token endpoint https://ssl.newsman.ro/admin/oauth/token folosind parametrii:

code=d869078edb8658f7ccaae5545d506662
redirect_uri=https%3A%2F%2Fsitulmeu.ro%2Fcallback
client_id=app_client_example
client_secret=123123123123
grant_type=authorization_code

Daca nu sunt erori, veti primi un raspuns JSON de forma:

{
    "user_id": 2312121,
    "access_token": "6c595cd6db27b05dya3be2f65e28291f",
    "expires_in": 1709550943,
    "lists": [1, 2],
    "token_type": "bearer",
    "scope": "api"
}

access_token obtinut (denumit API key) il veti folosi de fiecare data cand apelati API-ul impreuna cu user_id.

Postat de catalin pe July 1, 2013

Webhook import.csv (notificare import abonati)

Daca aveti o aplicatie care foloseste API-ul Newsman si incarcati / actualizati abonatii in baza de date, va putem notifica in momentul in care import-ul s-a terminat. Pentru a activa acest lucru, trebuie sa aveti definita in setarile listei Webhook URL. La adresa specificata in Setari (webhook url) veti primi un request POST ce contine unul sau mai multe Newsman Events.

Un event este compus din:

type – tipul event-ului (in cazul de fata: import)
timestamp – (data la care s-a petrecut event-ul)
data – array cu date custom ale fiecarui event in parte

Pentru event-ul de import, se trimit urmatoarele date:

import_id – ID-ul importului
status – text (finished / error)

Apelul facut de catre noi este POST si contine un singur parametru, newsman_events care contine un STRING encodat JSON. String-ul encodat JSON este un array de evenimente (unul sau mai multe evenimente Newsman).

Exemplu de cod PHP pentru a face DEBUG la evenimente:

<?php
print_r($_POST);
/*
Array
(
    [newsman_events] => [{"type":"import","timestamp":1372428476,"data":{"import_id":"51cd98951fbbbf972d000001","status":"finished"}}]
)
*/
 
$newsman_events = json_decode($_POST["newsman_events"]);
print_r($newsman_events[0]);
/* 
Array
(
    [type] => import
    [timestamp] => 1372428476
    [data] => Array
        (
            [import_id] => 51cd98951fbbbf972d000001
            [status] => finished
        )
 
)
*/
)
?>