Power BI et Microsoft Fabric

​

Prérequis

• Une clé API AthenaHQ (Organisation → onglet API). Consultez la page Authentification.
• Le website_id du site sur lequel vous souhaitez établir des rapports. Récupérez-le avec GET /api/v1/websites.
• Power BI Desktop ou un espace de travail Microsoft Fabric avec Dataflow Gen2 activé.

​

Configuration

curl https://api.athenahq.ai/api/v1/websites \
  -H "x-api-key: YOUR_API_KEY"

let
  ApiKey   = "YOUR_API_KEY",
  Website  = "YOUR_WEBSITE_ID",
  // Adjust to your reporting window. Format: ISO-8601 UTC.
  Body     = Json.FromValue([
               website_id = Website,
               filters    = [
                 start_date = "2024-01-01T00:00:00.000Z",
                 end_date   = "2024-01-31T23:59:59.999Z"
               ]
             ]),
  Source   = Web.Contents(
               "https://api.athenahq.ai",
               [
                 RelativePath = "/api/v1/metrics/share-of-voice/time-series",
                 Headers      = [
                   #"x-api-key"    = ApiKey,
                   #"Content-Type" = "application/json"
                 ],
                 Content      = Body
               ]
             ),
  Json     = Json.Document(Source),
  Data     = Json[data]
in
  Data

let
  ApiKey   = "YOUR_API_KEY",
  Website  = "YOUR_WEBSITE_ID",
  Source   = Web.Contents(
               "https://api.athenahq.ai",
               [
                 RelativePath = "/api/v1/prompts",
                 Query        = [ website_id = Website ],
                 Headers      = [ #"x-api-key" = ApiKey ]
               ]
             ),
  Json     = Json.Document(Source),
  Data     = Json[data]
in
  Data

let
  AsTable  = Table.FromList(Data, Splitter.SplitByNothing(), {"row"}),
  Expanded = if List.IsEmpty(Data) then
               AsTable
             else
               Table.ExpandRecordColumn(
                 AsTable,
                 "row",
                 Record.FieldNames(AsTable{0}[row])
               )
in
  Expanded

​

Considérations de sécurité

• Utilisez une clé API dédiée à cette intégration et limitée aux sites concernés. Créez une clé distincte de vos autres automatisations et limitez-la aux seuls sites nécessaires aux rapports. Consultez le périmètre des clés API. Ne réutilisez pas une clé d’organisation à périmètre étendu.
• Restreignez l’accès à l’espace de travail. Accordez les autorisations de modification, de création et de contribution sur l’espace Power BI, le jeu de données, le flux de données et le .pbix source au nombre minimal d’utilisateurs de confiance. Les lecteurs de Power BI Service ne peuvent pas consulter le code M, mais toute personne ayant accès au fichier .pbix peut l’ouvrir dans Desktop et le lire.
• Remplacez la clé en cas d’exposition présumée. Si les membres de l’espace de travail changent, si un .pbix est partagé à l’extérieur ou si vous suspectez une fuite, remplacez la clé depuis la page Clés API.
• Évitez de versionner les fichiers .pbix contenant la clé. Retirez la clé (ou utilisez un paramètre remplacé dans le service) avant de les ajouter au contrôle de version.

• Déployez un proxy léger que vous contrôlez. Hébergez un petit point de terminaison (Azure Function, Cloud Function, service interne) qui injecte la clé API AthenaHQ depuis un stockage sécurisé avant de transférer la requête. Le proxy doit imposer sa propre authentification (par exemple un compte Entra ID / Microsoft, un jeton par appelant, mTLS), ou n’être accessible que depuis un réseau interne ou via la passerelle de données locale Power BI. Si le proxy reste anonyme sur Internet, toute personne connaissant son URL peut appeler AthenaHQ en votre nom, exfiltrer vos données et épuiser votre quota. La clé ne figure jamais dans la requête M, mais sa protection dépend des contrôles d’accès placés devant le proxy.
• Créez un connecteur Power BI personnalisé (.mez). Les connecteurs personnalisés peuvent utiliser le magasin d’identifiants Power BI pour des en-têtes arbitraires et ainsi garder la clé hors du code source des rapports. Cela nécessite de développer le connecteur et de le distribuer par un administrateur.

​

Points de terminaison

​

Authentification

​

Limites de débit

​

Dépannage

• 401 Unauthorized : la clé API est absente, révoquée ou ne couvre pas le website_id demandé.
• Demandes d’identifiants en boucle dans Power BI Service : vérifiez que les informations d’identification de la source sont définies sur Anonyme pour https://api.athenahq.ai. Power BI ne peut pas stocker lui-même l’en-tête x-api-key ; la clé doit donc figurer dans la requête M.
• Avertissement d’URL dynamique de Web.Contents : conservez l’URL de base en dur et transmettez les parties dynamiques par les options RelativePath et Query. L’extrait ci-dessus suit déjà ce modèle.
• 405 Method Not Allowed : appeler un point de terminaison GET (par exemple /api/v1/prompts) avec Content force une requête POST, qui est refusée. Utilisez la variante GET de l’extrait.