Description
Use this feature to retrieve Bounce-Information about a newsletter. You can keep your system synchronous in regards to unsubscriptions this way, since the response contains information about addresses being removed from Backclick or not. An array of Bouncemail information will be returned. Here, the following details are included:
- E-Mail address
- Bouncecode
- Bouncemessage
- Did the address unsubscribe
- Bouncetype (SOFTBOUNCE / HARDBOUNCE)
Available starting from Backclick-Version: 5.8.9
In order to use this feature you have to provide the following information:
- Mandator ID
- API-Key (optional authentication, if not provided the IP address will be used for authentication)
- Newsletter ID to retrieve Bounce-Information for
Example
$client = new SoapClient($wsdlUrl);
$bounceMailRequest = new StdClass();
$bounceMailRequest->mandatorId = 0;
$bounceMailRequest->newsletterId = 10480;
try {
$result = $client->getBounceMails($bounceMailRequest);
var_dump($result);
} catch (Exception $e) {
echo "Fehler aufgetreten: " . $e->getMessage() . "\n";
}
object(stdClass)#3 (1) {
["bounceMails"]=>
object(stdClass)#4 (1) {
["item"]=>
array(12) {
[0]=>
object(stdClass)#5 (6) {
["bounceAddress"]=>
string(18) "[email protected]"
["bounceMessage"]=>
string(79) "550 5.1.8 <[email protected]>: Sender address rejected: Domain not found"
["bounceCode"]=>
int(550)
["bounceTime"]=>
int(1362648772)
["isUnsubscribed"]=>
bool(true)
["bounceType"]=>
string(10) "HARDBOUNCE"
}
}
}
}
Source code
In order to test a working example you can download the source code.
Example for retrieving Bouncemail-Information