REST API v4: GET destination/message abuses (Drag and drop)
Er worden statistieken bijgehouden over elke mailing die verstuurd wordt met Copernica om je meer inzicht te geven in de prestatie hiervan. Abuses zijn een van de statistieken die worden bijgehouden. Je kan de abuses voor een specifieke destination opvragen met een HTTP GET call naar de volgende URL:
https://api.copernica.com/v4/draganddrop/destination/{$destinationID}/abuses
Let op: De termen 'destination' en 'message' kunnen uitwisselbaar gebruikt worden, ook in de voorbeeldcode.
Parameters
De parameters voor deze methode kunnen ingesteld worden om alleen de statistieken voor een bepaalde periode op te halen. De volgende optionele parameters zijn beschikbaar:
- begintime: De tijdstempel waarna de abuse gemeld moet zijn (YYYY-MM-DD HH:MM:SS format).
- endtime: De tijdstempel waarvoor de abuse gemeld moet zijn (YYYY-MM-DD HH:MM:SS format).
Teruggegeven velden
Deze methode geeft een JSON object terug met abuses. Voor elke abuse is de volgende informatie beschikbaar:
- ID: De ID van de abuse.
- mailing: De ID van de mailing.
- timestamp: Tijdstempel van de abuse.
- report: Rapportage over de abuse.
- destination: De ID van de destination die de abuse rapporteerde.
- profile: De ID van het profiel die de abuse rapporteerde.
- subprofile: De ID van het subprofiel die de abuse rapporteerde.
JSON voorbeeld
Een enkele abuse ziet er bijvoorbeeld zo uit:
{
"ID":"12",
"mailing":"233482",
"timestamp":"2019-03-05 14:44:52",
"report":{
},
"destination":"1264524",
"profile":null,
"subprofile":null
}
PHP voorbeeld
Dit script demonstreert hoe je de API methode kunt gebruiken:
// vereiste scripts
require_once('CopernicaRestAPI.php');
// verander dit naar je access token
$api = new CopernicaRestAPI("your-access-token", 4);
// voer het verzoek uit
print_r($api->get("draganddrop/destination/{$destinationID}/abuses"));
Dit voorbeeld vereist de REST API klasse.
Meer informatie
- Overzicht van alle REST API calls
- Opvragen van alle abuses
- Opvragen van destination/message clicks voor MS
- Opvragen van destination/message deliveries voor MS
- Opvragen van destination/message errors voor MS
- Opvragen van destination/message impressions voor MS
- Opvragen van destination/message unsubscribes voor MS