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

Verwijder betaalrecords op transactie-ID, per bezoeker of binnen een datumbereik.

Bearer-token (werkruimtetoken of website-API-sleutel)

Werkruimtetokens hebben een websiteselector nodig

Werkruimte-API-tokens hebben toegang tot elke website in de werkruimte. Geef websiteId of domain mee, zodat Flowsery weet welke website je wilt opvragen of wijzigen. Website-API-sleutels horen al bij één website, dus daar kun je de selector weglaten.

Websiteselector

ParameterTypeBeschrijving
websiteIdstringWebsite-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel.
domainstringWebsitedomein om te gebruiken met een werkruimte-API-token als er geen websiteId is opgegeven. Laat weg als je authenticeert met een website-API-sleutel.

Minstens één filter verplicht

Je moet minstens één queryparameter meegeven. Dit endpoint aanroepen zonder filters geeft een 400-fout.

Queryparameters

ParameterTypeBeschrijving
transactionIdstringVerwijder de betaling met een specifieke transactie-ID.
visitorIdstringVerwijder alle betalingen die bij een specifieke bezoekers-ID horen.
startAtstringStarttijdstempel in ISO 8601 (bijv. 2024-01-01T00:00:00Z).
endAtstringEindtijdstempel in ISO 8601 (bijv. 2024-01-31T23:59:59Z).

Hoe verwijderen werkt

<strong>Alleen transactie-ID:</strong> verwijdert dat specifieke betaalrecord.

<strong>Alleen bezoekers-ID:</strong> verwijdert alle betalingen van die bezoeker (ooit).

<strong>Alleen tijdsbereik:</strong> verwijdert elke betaling binnen die periode.

<strong>Bezoekers-ID + tijdsbereik:</strong> verwijdert de betalingen van de bezoeker binnen het venster.

<strong>Transactie-ID + tijdsbereik:</strong> verwijdert de specifieke transactie als die binnen het bereik valt.

Geef je transactionId of visitorId op zonder tijdsbereik, dan worden ALLE overeenkomende records uit de hele geschiedenis verwijderd.

Foutantwoorden

<strong>400 Bad Request</strong> -- Er zijn geen filterparameters opgegeven.

<strong>401 Unauthorized</strong> -- Het API-token ontbreekt, is ongeldig of verlopen, of wordt niet geaccepteerd voor dit endpoint.

Een specifieke transactie verwijderen
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/payments?websiteId=flid_abc123&transactionId=payment_456" \
  -H "Authorization: Bearer <workspace-or-website-token>"
Betalingen van een bezoeker in een datumbereik verwijderen
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": "Payments deleted successfully"
    }
  ]
}