api-referenceDEL
DELETEhttps://analytics.flowsery.com/analytics/api/v1/goals

Supprimez des événements d'objectif personnalisés par visiteur, nom d'événement ou dans une plage de dates.

Jeton Bearer (jeton workspace ou clé API de site)

Les jetons d'espace de travail nécessitent un sélecteur de site Web

Les jetons de l'API Workspace peuvent accéder à tous les sites Web de l'espace de travail. Transmettez websiteId ou domain pour que Flowsery sache quel site Web interroger ou muter. Les clés API de site Web sont déjà limitées à un seul site Web, le sélecteur peut donc être omis.

Sélecteur de site Web

ParamètreTaperDescription
websiteIdstringID de site Web à utiliser avec un jeton API d'espace de travail. Omettre lors de l'authentification avec une clé API de site Web.
domainstringSite Web domain à utiliser avec un jeton API d'espace de travail lorsque websiteId n'est pas fourni. Omettre lors de l'authentification avec une clé API de site Web.

Au moins un filtre requis

Au moins un paramètre de requête doit être fourni. Appeler ce point de terminaison sans filtres retourne une erreur 400.

Paramètres de requête

ParamètreTaperDescription
visitorIdstringSupprimez les objectifs liés à un identifiant de visiteur spécifique.
namestringSupprimez les objectifs correspondant à un nom d'événement spécifique (par ex., signup, purchase).
startAtstringHorodatage de début ISO 8601 (par ex., 2024-01-01T00:00:00Z).
endAtstringHorodatage de fin ISO 8601 (par ex., 2024-01-31T23:59:59Z).

Comportement de suppression

<strong>Plage de temps uniquement :</strong> Supprime tous les objectifs dans cette période.

<strong>Identifiant de visiteur uniquement :</strong> Supprime tous les objectifs pour ce visiteur (toute la période).

<strong>Nom uniquement :</strong> Supprime tous les objectifs portant ce nom (toute la période).

<strong>Identifiant de visiteur + nom :</strong> Supprime les objectifs correspondant aux deux critères.

<strong>Plage de temps + filtres :</strong> Supprime les objectifs correspondant aux filtres dans la fenêtre donnée.

Fournir visitorId ou name sans plage de temps supprime TOUS les enregistrements correspondants dans tout l'historique.

Réponses d'erreur

<strong>400 Bad Request</strong> -- Aucun paramètre de filtre n'a été fourni.

<strong>401 Unauthorized</strong>: le jeton API est manquant, non valide, expiré ou non accepté pour ce point de terminaison.

Supprimer par nom dans une plage de dates
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/goals?websiteId=flid_abc123&name=signup&startAt=2024-01-01T00:00:00Z&endAt=2024-01-31T23:59:59Z" \
  -H "Authorization: Bearer <workspace-or-website-token>"
Supprimer tous les objectifs d'un visiteur
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/goals?websiteId=flid_abc123&visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd" \
  -H "Authorization: Bearer <workspace-or-website-token>"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 14,
      "message": "Goal completions deleted successfully"
    }
  ]
}