Journal d'activité
Le journal d'activité affiche vos requêtes API les plus récentes en temps réel. Utilisez-le pour déboguer des requêtes individuelles, vérifier les codes de réponse et confirmer que votre intégration fonctionne.
Ce que vous verrez
Le journal affiche les requêtes effectuées au cours de la dernière heure, avec les plus récentes en haut. Neuf colonnes composent la ligne complète :
| Colonne | Ce qu'elle affiche |
|---|---|
| Heure | Quand la requête a été effectuée |
| Clé | Quelle clé API a été utilisée |
| Requête | L'appel lui-même : un point de produit coloré (single, proxy ou browser), la méthode HTTP et le domaine cible. Trie par domaine. |
| Statut | Deux valeurs dans une cellule, séparées par une barre oblique : le statut HTTP de votre appel à FourA, puis le statut renvoyé par la cible. Un tiret signifie que la cible n'a jamais répondu. |
| Résultat | Classification de la requête (Succès, Erreur client, Limité par le taux, etc.) |
| Durée | Temps de réponse total en millisecondes |
| Octets | Transfert dans les deux sens dans une cellule : flèche vers le bas pour le payload de la requête, flèche vers le haut pour la réponse |
| Crédits | Crédits dépensés pour l'appel (voir En-têtes de réponse) |
| IP client | L'adresse qui a effectué la requête |
Cliquez sur n'importe quel en-tête de colonne pour trier le tableau par cette colonne ; la direction alterne entre décroissant, croissant, puis désactivé. Un clic avec Ctrl ou Cmd réinitialise à la valeur par défaut (les plus récents en premier).
Filtrage
Trois contrôles permettent de restreindre le journal.
Par clé API
Utilisez la liste déroulante des clés API pour afficher les requêtes d'une seule clé. Seules les clés comprises dans votre périmètre d'accès apparaissent dans la liste déroulante.
Par produit
Filtrez sur un seul endpoint avec le sélecteur single / proxy / browser. Utile lorsque vous souhaitez déboguer les échecs liés uniquement au navigateur séparément des requêtes simples.
Par limite
Le journal d'activité affiche 50 entrées par défaut. Utilisez le sélecteur de limite pour modifier le nombre d'entrées affichées :
| Limite | Notes |
|---|---|
| 10 | Examen rapide |
| 50 | Par défaut |
| 100 | Vue étendue |
| 200 | Maximum |
Toutes les entrées datent de la dernière heure. Pour les données historiques, utilisez la section Métriques, qui agrège les données sur des jours et des semaines.
Ouverture d'une requête
Cliquez sur n'importe quelle ligne pour ouvrir un panneau de détails avec l'aperçu complet du payload de la requête et de la réponse. Le panneau s'ouvre sur une grille de métadonnées construite à partir de la ligne elle-même, de sorte qu'il reste utile même après que le payload stocké a expiré : horodatage, clé, statut HTTP, statut de l'application, résultat, durée, crédits, proxy et la X-FourA-Request-Id de la requête.
Sous la grille, un seul volet s'affiche à la fois, sélectionné par onglet :
| Onglet | Ce qu'il affiche |
|---|---|
| Requête | JSON formaté du corps exact envoyé |
| En-têtes de réponse | Les en-têtes renvoyés par la cible, avec un décompte sur l'onglet |
| Corps de la réponse | L'aperçu du corps stocké, avec les badges tronqué et binaire là où ils s'appliquent |
| Autres champs | Tout ce que le moteur a renvoyé au-delà du statut, des temps, du proxy et des en-têtes. Masqué lorsqu'il n'y a rien de plus. |
Un bouton Copier copie le volet qui est ouvert. Les charges utiles sont conservées pendant 24 heures, limitées aux 200 dernières par clé API. Les lignes plus anciennes affichent uniquement la ligne, sans charge utile.
Messages du volet de corps
Le volet de corps utilise un texte d'espace réservé différent selon ce qui s'est passé :
| Message | Signification |
|---|---|
(no body — the request failed: <error>) |
La request a rencontré une erreur avant que la cible ne renvoie un corps |
(no body captured for this request) |
La charge utile a expiré ou n'a pas été stockée |
(empty body — the server returned 0 bytes) |
La cible a renvoyé une response réellement vide |
Ouvrir dans Playground
La boîte de dialogue de détail comporte un bouton Ouvrir dans Playground. Cliquez dessus pour charger la request archivée et la response archivée dans le formulaire Playground. À partir de là, vous pouvez ajuster les paramètres et rejouer sur l'API en direct, ou simplement inspecter ce qui a été renvoyé sans ré-exécuter la request.
Le bouton est désactivé pour les charges utiles non rejouables (bouchons de request surdimensionnés et routes non-API), avec une indication expliquant pourquoi.
Utilisation de l'ID de request
Chaque response d'API comporte un header X-Foura-Request-Id. Consignez-le de votre côté et vous pourrez le coller dans un ticket de support pour indiquer la request exacte dans le journal d'activité. L'ID est le même que celui utilisé dans cette boîte de dialogue et correspond au X-Foura-Request-Id renvoyé par l'API. Voir Response Headers pour plus de détails.
Liens connexes
- Métriques et analytique : Données de performances agrégées sur des périodes plus longues
- Playground : Rejouer des requests depuis l'Activité
- Response Headers : D'où proviennent l'ID de request et les crédits
- Endpoints de l'API : Formes des requests et des responses
- Dépannage : Problèmes courants et solutions