Génération de Jetons d'Accès aux Rapports pour l'Intégration

Ce guide explique comment générer des jetons pour intégrer en toute sécurité les rapports de notre plateforme dans vos applications ou pages web à l'aide d'une iframe.

Génération d'un Jeton d'Accès au Rapport de 5 Minutes

Pour intégrer un rapport spécifique, générez un jeton à courte durée de vie en utilisant votre jeton d'API personnel.

Vous aurez besoin de :

  • Votre Jeton d'API Personnel
  • L'ID du Rapport, que vous trouverez dans l'URL du rapport ou via l'API

Point de Terminaison de l'API :

POST /api/reports/{report_id}/generate-token

Exemple : Utilisation de cURL

curl -X POST "https://pyqueryhub.com/api/reports/ID_DU_RAPPORT_ICI/generate-token" \
     -H "Authorization: Bearer VOTRE_JETON_API_PERSONNEL" \
     -H "Accept: application/json"

Explication :

  • -X POST : Effectue une requête POST.
  • Authorization : Utilise votre Jeton d'API Personnel.
  • Accept : Spécifie que vous voulez du JSON.

Réponse de l'API (Exemple)

{
  "message": "Jeton d'accès au rapport généré avec succès.",
  "token": "valeurDeJetonAleatoireACourteDureeGenereeParLapi",
  "report_id": "ID_DU_RAPPORT_ICI",
  "expires_at": "2025-05-20T19:15:00.000000Z",
  "view_url": "https://pyqueryhub.com/api/reports/{ID_DU_RAPPORT_ICI}/view/{valeurDeJetonAleatoireACourteDureeGenereeParLapi}"
}
  • token : Le jeton d'accès au rapport à courte durée de vie.
  • view_url : Utilisez ceci dans le src de votre iframe.
  • expires_at : Date d'expiration du jeton (5 minutes).

Si la requête échoue (par ex., jeton invalide ou absence de permission), l'API renvoie une erreur 4xx avec une explication en JSON.

{danger} N'appelez ceci que sur votre back-end. Gardez le Jeton d'API secret

Partie 3 : Utilisation de view_url dans une Iframe

Intégrez le rapport en utilisant la view_url :

<iframe src="COLLEZ_LA_VIEW_URL_ICI"
        width="100%"
        height="600px"
        frameborder="0"
        title="Rapport Intégré">
</iframe>

Exemple :

<iframe src="https://pyqueryhub.com/api/reports/ID_DU_RAPPORT_ICI/view/valeurDeJetonAleatoireACourteDureeGenereeParLapi"
        width="100%"
        height="600px"
        frameborder="0"
        title="Nom du Rapport Intégré">
</iframe>

⚠️ La view_url expire après 5 minutes. Si un utilisateur actualise ou revisite la page plus tard, générez un nouveau jeton par programme.

Notes Importantes

  • Sécurité : N'exposez jamais votre Jeton d'API Personnel dans du code accessible au public. Utilisez une logique côté serveur pour la génération de jetons.
  • Expiration du Jeton : La limite de 5 minutes améliore la sécurité. Concevez votre application pour gérer le rafraîchissement des jetons selon les besoins.

Si vous rencontrez des problèmes, inspectez la réponse de l'API ou contactez le support.