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

Supprimez des evenements d'objectif personnalises par visiteur, nom d'evenement 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 <code>websiteId</code> ou <code>domain</code> 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

ParametreTaperDescription
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 parametre de requete doit etre fourni. Appeler ce point de terminaison sans filtres retourne une erreur 400.

Parametres de requete

ParametreTaperDescription
visitorIdstringSupprimez les objectifs lies a un identifiant de visiteur specifique.
namestringSupprimez les objectifs correspondant a un nom d'evenement specifique (par ex., signup, purchase).
startAtstringHorodatage de debut 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 periode.

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

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

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

<strong>Plage de temps + filtres :</strong> Supprime les objectifs correspondant aux filtres dans la fenetre donnee.

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

Reponses d'erreur

<strong>400 Bad Request</strong> -- Aucun parametre de filtre n'a ete 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 events deleted successfully"
    }
  ]
}