API - Newsletter¶

Subscribe to newsletter¶

URL: /api/newsletter/
Method: POST

Code sample:¶

$api_id = 1;
$api_key = 'testpass';
$hostname = 'https://example.com'; // no trailing slash

# fetch data
$url = '/api/newsletter/';
$post_data = array(
    'email' => 'john.doe2@gmail.com',
    'action' => 'subscribe',
    'source' => 'teaser',
);
$user_token = 'xxx'; // is required here. Get it from Your DB after Token generation
$extra_headers = array(
    'X-API-ID: ' . $api_id,
    'X-API-Hash: ' . md5($api_key . $url. http_build_query($post_data)),
    'X-User-Token: ' . $user_token
);

header('Content-Type: application/json; charset=utf-8');
echo sendRequest($hostname . $url, $post_data, $extra_headers);

Succes message:

{
    has_error: false,
    messages: [ ],
    results: {
        bf7119cc5b98d6da544e64cfce4f1fcb: "Pe adresa de email 'john.doe2@gmail.com' a fost trimis un mesaj de confirmare. Pentru a finaliza abonarea la lista 'Newsletter saptamanal XXX' este necesar sa apasati link-ul de confirmare din mesajul primit.<br /><br />Nu uitati sa verificati si folderul SPAM sau BULK. Daca ati primit mesajul in acest folder, apasati butonul 'Not Spam' pentru a putea primi mesajele in Inbox." 
    }
}

Error message:

{
    has_error: true,
    messages: [
        "Inca nu ati confirmat abonarea la lista 'Newsletter saptamanal XXX' facand click pe mailul trimis la adresa 'john.doe1@gmail.com'. Daca doriti sa retrimiteti mailul de confirmare <a href='https://example.com/news/?resendHash=xxx' target='_blank'>click aici</a>" 
    ],
    results: [ ]
}

Unsubscribe from newsletter¶

URL: /api/newsletter/
Method: POST

Code sample:¶

...
$url = '/api/newsletter/';
$post_data = array(
    'email' => 'john.doe2@gmail.com',
    'action' => 'unsubscribe'
);
...

Succes message:

{
    has_error: false,
    messages: [ ],
    results: [
        "Ati fost dezabonat de la lista 'Newsletter saptamanal XXX'" 
    ]
}

{
    has_error: false,
    messages: [ ],
    results: [
        "Nu sunteti abonat la newsletter" 
    ]
}