Authentification

 

Avant-propos

Une clé API donne les mêmes permissions que l’utilisateur qui l’a créée. Si l’utilisateur perd ses droits sur un site, il ne pourra plus utiliser sa clé API pour obtenir des données sur ce site. Si l’utilisateur obtient des droits sur un nouveau site, il pourra utiliser sa clé API pour obtenir des données sur ce site.

La clé API est destinée à être utilisée avec les URL API récupérées à partir de Data Query. Si vous êtes un utilisateur SSO, vous devez utiliser une clé API pour interroger l’API REST d’AT Internet.

Vous pouvez créer une nouvelle clé API sur votre page de profil.

Une clé API ne peut être créée que par un utilisateur authentifié qui peut manipuler des données. Cet utilisateur doit avoir au moins l’un des rôles suivants :

  • Administrateurs
  • Délégués
  • Analystes avancés
  • Analystes ou Rôles personnalisés avec l’outil « Manipuler les données ».

La clé API est créée, activée, désactivée et supprimée par chaque utilisateur indépendamment.

La clé API doit être incluse dans toutes les requêtes API adressées au serveur dans un en-tête qui ressemble à ce qui suit : x-api-key: YOURAPIKEY

 
 

Exemples

Vous pouvez vous authentifier à notre API en passant votre clé API dans l’en-tête, voici quelques possibilités.
 

xhr.setRequestHeader("x-api-key", "YOURAPIKEY"); 

curl "https://api.atinternet.io/v3/data/getData"
-H "x-api-key: YOURAPIKEY"

headers = {
    'x-api-key': "YOURAPIKEY",
}

request["x-api-key"] = 'YOURAPIKEY'
request.body = "{\n \"columns\": [\n   \"visit_device_type\",\n   \"m_visits\",\n   \"m_users\"\n ],\n \"sort\": [\n   \"-m_visits\"\n ],\n\"space\": {\n   \"s\": [\n     429023\n   ]\n },\n \"period\": {\n   \"p1\": [\n     {\n       \"type\": \"D\",\n       \"start\": \"2019-10-24\",\n       \"end\": \"2019-10-24\"\n     }\n   ]\n },\n \"max-results\": 50,\n \"page-num\": 1\n}"
response = http.request(request)
puts response.read_body

 

Dernière mise à jour : 07/04/2022