> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Journaux de Développeur

> Accédez et interprétez les journaux d'API dans la plateforme d'administration Topsort

## Où Trouver les Journaux

Naviguez vers l'onglet **Outils de Développement** dans votre Plateforme Publicitaire Topsort pour accéder aux journaux en temps réel de votre clé API.

## Disponibilité des Journaux

| Environnement  | Ce Qui est Enregistré                    | Rétention |
| -------------- | ---------------------------------------- | --------- |
| **Staging**    | Toutes les requêtes et réponses de l'API | 30 jours  |
| **Production** | Erreurs et requêtes échouées uniquement  | 30 jours  |

<Note>
  À mesure que votre utilisation de l'API de production augmente, les requêtes réussies peuvent être filtrées des journaux pour améliorer les performances. Les erreurs et les informations de débogage seront toujours disponibles.
</Note>

## Comprendre les Entrées de Journal

### Requêtes Réussies

<img src="https://mintcdn.com/topsort/oVmv62U7qVFoTD_d/en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp?fit=max&auto=format&n=oVmv62U7qVFoTD_d&q=85&s=430bfba5e57697b63ab0eaa29747322a" alt="Capture d'écran de notification du validateur de schéma" width="1278" height="951" data-path="en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp" />

Les appels API réussis affichent :

* **Statut :** Codes de statut HTTP 200/201/204
* **Horodatage :** Quand la requête a été effectuée
* **Endpoint :** Quel endpoint de l'API a été appelé
* **Temps de réponse :** Combien de temps la requête a pris
* **Taille de la requête :** Taille des données de requête/réponse

### Entrées d'Erreur

<img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=1562f907c238249ec7141353afe2ab00" alt="Capture d'écran d'erreur du validateur de schéma" width="1297" height="463" data-path="en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp" />

Les requêtes échouées incluent des informations de débogage supplémentaires :

* **Statut :** Code d'erreur HTTP (400, 401, 403, etc.)
* **Détails de l'erreur :** Code d'erreur spécifique et message
* **Corps de la requête :** Quelles données ont été envoyées (pour le débogage)
* **Stack trace :** Détails internes de l'erreur (lorsque disponible)

## Modèles Courants de Journal

### Problèmes d'Authentification

```
401 Unauthorized - invalid_api_key
Missing Authorization header
```

**Solution :** Ajoutez l'en-tête `Authorization: Bearer VOTRE_CLE_API`

### Erreurs de Validation

```
422 Unprocessable Entity - invalid_product_id
Product 'sku_123' not found in catalog
```

**Solution :** Vérifiez que le produit existe et est correctement orthographié

### Limitation de Débit

```
429 Too Many Requests - rate_limited
X-RateLimit-Remaining: 0
```

**Solution :** Implémentez une logique de nouvelle tentative avec backoff exponentiel

## Utiliser les Journaux pour le Débogage

### 1. Événements N'apparaissant Pas dans le Tableau de Bord

Recherchez :

* **Statut 200** sur les appels `/events`
* **Erreurs de validation** dans le payload de l'événement
* **Problèmes d'horodatage** (`occurredAt` dans le futur ou trop ancien)

### 2. Résultats d'Enchères Vides

Vérifiez :

* Statut du budget de campagne
* Disponibilité du produit dans le catalogue
* Format de la requête d'enchère

### 3. Problèmes d'Attribution

Examinez les journaux d'événements pour :

* Utilisation cohérente de l'ID utilisateur
* `resolvedBidId` approprié des enchères
* Timing des événements de clic/achat

## Meilleures Pratiques

### Surveillance des Journaux

* Vérifiez les journaux après avoir déployé un nouveau code d'intégration
* Surveillez les taux d'erreur pendant les périodes de trafic élevé
* Configurez des alertes pour les modèles d'erreur récurrents

### Flux de Travail de Dépannage

1. **Reproduisez le problème** dans l'environnement de staging
2. **Vérifiez les journaux récents** pour les modèles d'erreur
3. **Vérifiez le format de la requête** par rapport à la [documentation de l'API](/fr/api-reference)
4. **Testez avec un payload minimal** pour isoler le problème
5. **Contactez le support** avec les horodatages des journaux pour les problèmes complexes

## Confidentialité et Traitement des Données

* Les journaux peuvent contenir des données sensibles de vos requêtes
* Les journaux de production expirent automatiquement après 30 jours
* L'accès aux journaux est réservé uniquement aux utilisateurs administrateurs
* Les données personnelles dans les journaux suivent les politiques standard de rétention des données

## Besoin d'Aide ?

Si vous constatez des erreurs persistantes dans vos journaux :

1. **Notez l'horodatage** des requêtes problématiques
2. **Copiez le message d'erreur exact** et les détails de la requête
3. **Contactez le support** avec ces informations pour une résolution plus rapide

Notre équipe peut accéder aux journaux détaillés côté serveur pour aider à diagnostiquer les problèmes d'intégration complexes.