REST API v3: GET logfiles names

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/v3/logfiles?access_token=xxxx&date=$date&type=$type

In deze URL kun je twee parameters meegeven: $date kan gebruikt worden om een specifieke datum mee te geven waarvoor je de namen van de logfiles wilt zien. Hetzelfde doet $type voor het type logfile. Een overzicht daarvan vindt je in de tabel onder het kopje "Teruggegeven velden". Beide parameters zijn optioneel. Als je beide gebruikt worden de files gefilterd op zowel datum als type. Als je geen van beide gebruikt krijg je de datums waarvoor logfiles bestaan terug.

Teruggegeven velden

Deze methode geeft een JSON array terug met de namen van logfiles. De types van de logfiles staan hieronder in de tabel.

Voor meer informatie over het downloaden van deze files in het gewenste formaat kun je de documentatie onder het kopje "Meer informatie" bekijken.

Voorbeeld in PHP

Het volgende PHP script demonstreert hoe je de API methode gebruikt. Vergeet niet de datum in te voegen in de URL (YYYY-MM-DD formaat).

// vereiste scripts
require_once('copernica_rest_api.php');

// verander dit naar je access token
$api = new CopernicaRestAPI("your-access-token", 3);

// de array voor de gewenste datum en/of het gewenste type van de logfiles
$parameters = array(
    'type' =>     "cdm-attempts",
    'date' =>     "2019-01-01",
);

// voer het verzoek uit en print het resultaat
print_r($api->get("logfiles", $parameters));

Dit voorbeeld vereist de REST API klasse.

Meer informatie

• Overzicht van API calls
• Downloaden van een logfile in JSON formaat
• Downloaden van een logfile in CSV formaat
• Downloaden van een logfile in XML formaat