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

Supprimez des enregistrements de paiement par identifiant de transaction, visiteur 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
transactionIdstringSupprimez le paiement correspondant a un identifiant de transaction specifique.
visitorIdstringSupprimez tous les paiements lies a un identifiant de visiteur specifique.
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>Identifiant de transaction uniquement :</strong> Supprime l'enregistrement de paiement specifique.

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

<strong>Plage de temps uniquement :</strong> Supprime tous les paiements dans cette periode.

<strong>Identifiant de visiteur + plage de temps :</strong> Supprime les paiements du visiteur dans la fenetre.

<strong>Identifiant de transaction + plage de temps :</strong> Supprime la transaction specifique si elle se situe dans la plage.

Fournir <code>transactionId</code> ou <code>visitorId</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 une transaction specifique
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/payments?websiteId=flid_abc123&transactionId=payment_456" \
  -H "Authorization: Bearer <workspace-or-website-token>"
Supprimer les paiements d'un visiteur dans une plage de dates
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/payments?visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd&startAt=2024-01-01T00:00:00Z&endAt=2024-03-31T23:59:59Z" \
  -H "Authorization: Bearer <workspace-or-website-token>"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 3,
      "message": "Payment records deleted successfully"
    }
  ]
}