REST API v4: GET logfiles .xml
Copernica houdt logfiles bij die je op kunt vragen met de API. Deze methode kan gebruikt worden om een logfile op te vragen als een CSV bestand met de bestandsnaam. Instructies voor het opvragen van een bestandsnaam kun je vinden onder het kopje "Meer informatie". Om de methode aan te roepen verstuur je een HTTP GET verzoek naar de volgende URL:
https://api.copernica.com/v4/logfile/$bestandsnaam/xml
Hier moet je $bestandsnaam vervangen door de bestandsnaam.
Beschikbare parameters
De volgende parameters kunnen aan de URL als variabelen worden toegevoegd:
- from: unix timestamp vanaf welk moment de logfile wordt uitgelezen. Alleen
logregels met een tijdstip na deze timestamp worden teruggegeven. Let op:
deze parameter is uitsluitend beschikbaar via het endpoint
https://rest.copernica.comen werkt niet viahttps://api.copernica.com.
Voorbeeld
In onderstaand voorbeeld worden alleen logregels opgehaald vanaf de opgegeven timestamp.
https://rest.copernica.com/v4/logfile/cdm-impression.2026-03-24.log/xml?from=1774389600
Teruggegeven bestand
Deze functie geeft een XML representatie van de opgevraagde logfile terug. Er volgt nu een voorbeeld van hoe zo'n representatie eruit ziet.
<records>
<record>
<id>XXXXXXXXXX1</id>
<time>2016-11-04 11:01:00</time>
<mailingid>12345</mailingid>
<profileid>1111111</profileid>
<subprofileid>2</subprofileid>
<databaseid>133</databaseid>
<collectionid>0</collectionid>
<senderdomain>copernica.com</senderdomain>
<templateid>1234</templateid>
<tags></tags>
<email>employee1234@copernica.com</email>
</record>
<record>
...
</record>
...
</records>
Voorbeeld in PHP
Het volgende PHP script demonstreert hoe je de API methode gebruikt. Vergeet
niet de bestandsnaam in te voeren. Een voorbeeld van zo'n bestandsnaam is
cdm-attempts.2016-11-04.log om de afleverpogingen van 4 November 2016 op
te vragen.
// vereiste scripts
require_once('CopernicaRestAPI.php');
// verander dit naar je access token
$api = new CopernicaRestAPI("your-access-token", 4);
// voer het verzoek uit en print het resultaat
print_r($api->get("logfile/{$bestandsnaam}/xml"));
Dit voorbeeld vereist de REST API klasse.