REST API v1: GET logfiles names
Waarschuwing: Je bekijkt nu het overzicht voor de oude versie van onze API. Wij raden aan om onze laastste versie van de API te gebruiken.
Copernica houdt logfiles bij over bijvoorbeeld clicks, opens, errors, ontvangen berichten, etc. Deze logfiles kunnen gedownload worden met de API of via het dashboard. Door een HTTP GET verzoek te sturen naar de volgende URL krijg je een lijst van alle bestaande logfiles voor een datum.
https://api.copernica.com/v1/logfiles/$date?access_token=xxxx
Je moet hier $date vervangen door de datum waarvoor je logfiles wilt zien.
Teruggegeven velden
Deze methode geeft een JSON array terug met de namen van logfiles. De types van de logfiles staan hieronder in de tabel. De naam van een logfile bevat het type als prefix en ook de datum.
prefix | type informatie |
---|---|
cdm-attempts | Algemene info over mails verstuurd met Marketing Suite (MS) |
cdm-abuse | Info over mails verstuurd met MS die een 'misbruik' notificatie veroorzaakten |
cdm-click | Info over clicks in mails verstuurd via MS |
cdm-delivery | Info over aangekomen mails verstuurd via MS |
cdm-error | Info over errors in mails verstuurd via MS |
cdm-impression | Info over impressies uit mails verstuurd via MS |
cdm-retry | Info over herzonden mails verstuurd via MS |
cdm-unsubscribe | Info over uitschrijvingen als gevolg van een mail verstuurd via MS |
pom-attempts | Algemene info over mails verstuurd met Publisher |
pom-abuses | Info over mails verstuurd met Publisher die een misbruik' notificatie veroorzaakten |
pom-clicks | Info over clicks in mails verstuurd via Publisher |
pom-deliveries | Info over aangekomen mails verstuurd via Publisher |
pom-errors | Info over errors in mails verstuurd via Publisher |
pom-impressions | Info over impressies uit mails verstuurd via Publisher |
pom-retries | Info over herzonden mails verstuurd via Publisher |
pom-unsubscribes | Info over uitschrijvingen als gevolg van een mail verstuurd via Publisher |
Voor meer informatie over het downloaden van deze files kun je de documentatie onder het kopje "Meer informatie" bekijken.
Voorbeeld in PHP
Het volgende PHP script demonstreert hoe je de API methode gebruikt:
// vereiste scripts
require_once('copernica_rest_api.php');
// verander dit naar je access token
$api = new CopernicaRestApi("your-access-token");
// voer het verzoek uit en print het resultaat
print_r($api->get("logfiles/2017-02-12"));
Dit voorbeeld vereist de REST API class.