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

Zahlungsdatensaetze nach Transaktions-ID, Besucher oder innerhalb eines Datumsbereichs loeschen.

API-Schluessel (Bearer-Token)

Mindestens ein Filter erforderlich

Mindestens ein Abfrageparameter muss angegeben werden. Der Aufruf dieses Endpunkts ohne Filter gibt einen 400-Fehler zurueck.

Abfrageparameter

ParameterTypBeschreibung
transactionIdstringDie Zahlung entfernen, die einer bestimmten Transaktions-ID entspricht.
visitorIdstringAlle Zahlungen entfernen, die an eine bestimmte Besucher-ID gebunden sind.
startAtstringISO 8601 Startzeitstempel (z. B. 2024-01-01T00:00:00Z).
endAtstringISO 8601 Endzeitstempel (z. B. 2024-01-31T23:59:59Z).

Loeschverhalten

<strong>Nur Transaktions-ID:</strong> Entfernt den spezifischen Zahlungsdatensatz.

<strong>Nur Besucher-ID:</strong> Entfernt alle Zahlungen fuer diesen Besucher (gesamter Zeitraum).

<strong>Nur Zeitraum:</strong> Entfernt alle Zahlungen innerhalb dieses Zeitraums.

<strong>Besucher-ID + Zeitraum:</strong> Entfernt Zahlungen fuer den Besucher innerhalb des Zeitfensters.

<strong>Transaktions-ID + Zeitraum:</strong> Entfernt die spezifische Transaktion, wenn sie in den Zeitraum faellt.

Die Angabe von <code>transactionId</code> oder <code>visitorId</code> ohne Zeitraum loescht ALLE uebereinstimmenden Datensaetze ueber den gesamten Verlauf.

Fehlerantworten

<strong>400 Bad Request</strong> -- Es wurden keine Filterparameter angegeben.

<strong>401 Unauthorized</strong> -- API-Schluessel fehlt oder ist ungueltig.

Eine bestimmte Transaktion loeschen
curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?transactionId=payment_456" \
  -H "Authorization: Bearer flow_sk_live_abc123"
Zahlungen eines Besuchers in einem Zeitraum loeschen
curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd&startAt=2024-01-01T00:00:00Z&endAt=2024-03-31T23:59:59Z" \
  -H "Authorization: Bearer flow_sk_live_abc123"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 3,
      "message": "Payment records deleted successfully"
    }
  ]
}