L'API de Fasterize permet de récupérer les logs d'accès de votre compte pour les sept derniers jours au format JSON ou Apache.


Veuillez contacter notre support pour obtenir le token d'API. Assurez-vous également d'avoir l'identifiant de configuration, que vous pouvez repérer dans l'URL du tableau de bord de votre configuration. Par exemple, si l'URL est https://dashboard.fasterize.com/feo/projects/64/configuration/1, l'identifiant de configuration est 1.


L'URL de l'API correspondante aux logs d'accès est https://api.fasterize.com/v2/configs/$config_id/logs.


Paramétrage

Il existe différents paramètres :


  • from : secondes depuis l'époque unix
  • to : secondes depuis l'époque unix
  • domain : liste des domaines ciblés
  • onlySeoVisit : filtre les logs des visiteurs en provenance d'un moteur de recherche (Google, Bing, Baidu, Yandex)
  • onlySearchBot : filtre les logs provenant du trafic des bots des moteurs de recherche (Google, Bing, Baidu, Yandex)
  • format : json ou apache


Remarque importante

Dans notre cas, les logs fournis par l’API proviennent de l'ingestion des logs de CloudFront.
Le système de récupération des logs CloudFront a un délai d'environ 30 minutes par rapport au temps réel.

En l'absence du paramètre 'from', la réponse renvoie aucun logs.
N'hésitez pas à ajuster vos paramètres en conséquence pour obtenir des résultats pertinents.

Si vous souhaitez récupérer les logs des 15 dernières minutes :
Soustrayez 900 secondes (= 15 minutes) du timestamp actuel.

Pour obtenir cette valeur, vous pouvez utiliser un convertisseur de timestamp Unix, comme celui disponible sur le site https://www.unixtimestamp.com

Utilisez la valeur comme argument pour le paramètre from dans votre URL pour récupérer les logs des 15 dernières minutes.


Exemple d'appel à l'API


# Récupérer les logs des quinze dernières minutes

curl "https://api.fasterize.com/v2/configs/$config_id/logs?from=$timestamp_unix" -H"Authorization:$myApiToken"


# Récupérer les logs de la veille

from=$(date -d "yesterday 00:00:00" '+%s')

to=$(date -d "yesterday 23:59:59" '+%s')

curl "https://api.fasterize.com/v2/configs/${configID}/logs?from=${from}&to=${to}" -H"Authorization:${token}"


Format de la réponse


Chaque log est constitué des champs suivants :

  • client_ip (adresse IPv4 du client),
  • content_length
  • content_type
  • domain
  • fstrz_flags  (voir la liste des champs)
  • method
  • protocol
  • referer
  • response_time (in msec)
  • status
  • timestamp
  • url
  • user_agent
  • user_agent_class (mobile / desktop_recent / tablet / bot / old)

Exemple :

{
  "client_ip":"217.167.19.73",
  "content_length":40945,
  "content_type":"text/html;charset=UTF-8",
  "domain":"www.nocibe.fr",
  "fstrz_flags":"o",
  "method":"GET",
  "protocol":"http",
  "referer":"",
  "request_id":"42024b74-f79f-4173-91b5-c2c9f236c57d",
  "response_time":1.552,
  "status":"200",
  "timestamp":"2017-04-10T15:38:18.830Z",
  "url":"/giorgio-armani-si-gel-douche-p-206477",
  "user_agent":"Screaming Frog SEO Spider/7.2","user_agent_class":"desktop_recent"
}


Apache Combined Log Format


Le format de logs Apache utilisé est le format combined :


LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""


Ce format est le seul supporté par des outils d'analyse SEO tels que Screaming Frog Log Analyser.