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

# Erreurs réseau

> Obtenez une répartition agrégée des erreurs edge 5xx (et éventuellement 4xx) pour l'application.

Renvoie le nombre agrégé d'erreurs edge de l'application sur une fenêtre temporelle, groupé par code de statut, intervalle de temps, chemin de requête et méthode HTTP. Par défaut, seules les réponses 5xx sont incluses ; passez `include_4xx=true` pour comptabiliser également les réponses 4xx.

<Info>
  Limite de débit en cas de cache miss : 15 requêtes par 60 secondes par propriétaire. Renvoie une répartition vide lorsqu'il n'y a aucune erreur correspondante ou lorsque la fenêtre précède la date de création de l'application.
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

### Paramètres

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID de l'application. Vous pouvez le trouver dans l'URL du tableau de bord de votre application.
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  Horodatage de début ISO 8601 pour la fenêtre d'analyse.
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  Horodatage de fin ISO 8601. Doit être postérieur à `start`.
</ParamField>

<ParamField query="include_4xx" type="string" placeholder="false">
  Indique s'il faut inclure les réponses 4xx en plus des erreurs 5xx. Accepte `true` ou `false`. Par défaut `false`.
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Indique si l'appel a réussi. `success` en cas de succès, `error` sinon.
</ResponseField>

<ResponseField name="response" type="object">
  Répartition agrégée des erreurs pour la fenêtre.

  <Expandable title="Afficher l'objet de réponse">
    <ResponseField name="summary" type="object">
      Totaux globaux pour la fenêtre.

      <Expandable title="Afficher l'objet summary">
        <ResponseField name="total" type="integer">Nombre total de réponses en erreur dans la fenêtre.</ResponseField>

        <ResponseField name="by_class" type="object">
          Totaux répartis par classe de statut HTTP.

          <Expandable title="Afficher l'objet by_class">
            <ResponseField name="4xx" type="integer">Total des réponses 4xx (renseigné uniquement lorsque `include_4xx=true`).</ResponseField>
            <ResponseField name="5xx" type="integer">Total des réponses 5xx.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_status" type="array">
      Nombre de requêtes groupées par chaque code de statut HTTP individuel observé.

      <Expandable title="Afficher l'élément by_status">
        <ResponseField name="status" type="integer">Code de statut HTTP (par ex. `502`, `504`).</ResponseField>
        <ResponseField name="requests" type="integer">Nombre total de requêtes ayant renvoyé ce code de statut.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="timeseries" type="array">
      Décomptes par intervalle de temps sur la fenêtre d'analyse.

      <Expandable title="Afficher l'élément timeseries">
        <ResponseField name="date" type="string">Horodatage de début de l'intervalle au format ISO 8601.</ResponseField>
        <ResponseField name="buckets" type="object">Objet indexé par code de statut HTTP avec le décompte observé dans cet intervalle.</ResponseField>
        <ResponseField name="total" type="integer">Total des erreurs observées dans cet intervalle.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="top_paths" type="array">
      Chemins ayant produit le plus d'erreurs durant la fenêtre.

      <Expandable title="Afficher l'élément top_paths">
        <ResponseField name="path" type="string">Chemin de la requête.</ResponseField>
        <ResponseField name="method" type="string">Méthode HTTP.</ResponseField>
        <ResponseField name="total" type="integer">Total des erreurs pour ce chemin/cette méthode.</ResponseField>
        <ResponseField name="by_status" type="object">Décomptes par code de statut HTTP observé pour ce chemin/cette méthode.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_method" type="array">
      Totaux d'erreurs agrégés groupés par méthode HTTP.

      <Expandable title="Afficher l'élément by_method">
        <ResponseField name="method" type="string">Méthode HTTP.</ResponseField>
        <ResponseField name="total" type="integer">Total des erreurs pour cette méthode.</ResponseField>
        <ResponseField name="by_status" type="object">Décomptes par code de statut HTTP observé pour cette méthode.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "summary": {
        "total": 42,
        "by_class": {
          "4xx": 0,
          "5xx": 42
        }
      },
      "by_status": [
        { "status": 502, "requests": 30 },
        { "status": 504, "requests": 12 }
      ],
      "timeseries": [
        {
          "date": "2025-12-01T12:00:00.000Z",
          "buckets": { "502": 5, "504": 2 },
          "total": 7
        }
      ],
      "top_paths": [
        {
          "path": "/api/users",
          "method": "GET",
          "total": 18,
          "by_status": { "502": 15, "504": 3 }
        }
      ],
      "by_method": [
        {
          "method": "GET",
          "total": 30,
          "by_status": { "502": 22, "504": 8 }
        }
      ]
    }
  }
  ```
</ResponseExample>
