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

Usuwa zdarzenia własnych celów według odwiedzającego, nazwy zdarzenia lub zakresu dat.

Bearer Token (token obszaru roboczego lub klucz API witryny)

Tokeny obszaru roboczego wymagają wskazania witryny

Tokeny API obszaru roboczego mają dostęp do wszystkich witryn w obszarze. Należy przekazać websiteId lub domain, aby Flowsery wiedziało, której witryny dotyczy zapytanie lub zmiana. Klucze API witryn są już przypisane do jednej witryny, więc można to pominąć.

Wskazanie witryny

ParametrTypOpis
websiteIdstringID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny.
domainstringDomena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny.

Wymagany co najmniej jeden filtr

Należy podać co najmniej jeden parametr zapytania. Wywołanie bez filtrów zwraca błąd 400.

Parametry zapytania

ParametrTypOpis
visitorIdstringUsuwa cele powiązane z danym identyfikatorem odwiedzającego.
namestringUsuwa cele o danej nazwie zdarzenia (np. signup, purchase).
startAtstringZnacznik czasu początku w ISO 8601 (np. 2024-01-01T00:00:00Z).
endAtstringZnacznik czasu końca w ISO 8601 (np. 2024-01-31T23:59:59Z).

Działanie usuwania

<strong>Tylko zakres czasu:</strong> usuwa wszystkie cele z tego okresu.

<strong>Tylko ID odwiedzającego:</strong> usuwa wszystkie cele tego odwiedzającego (z całego okresu).

<strong>Tylko nazwa:</strong> usuwa wszystkie cele o tej nazwie (z całego okresu).

<strong>ID odwiedzającego + nazwa:</strong> usuwa cele spełniające oba kryteria.

<strong>Zakres czasu + filtry:</strong> usuwa cele pasujące do filtrów w podanym okresie.

Podanie visitorId lub name bez zakresu czasu usuwa WSZYSTKIE pasujące rekordy z całej historii.

Odpowiedzi z błędami

<strong>400 Bad Request</strong> -- Nie podano parametrów filtrowania.

<strong>401 Unauthorized</strong> -- Token API jest nieobecny, nieprawidłowy, wygasł lub nie jest akceptowany przez ten punkt końcowy.

Usuwanie według nazwy w zakresie dat
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>"
Usuwanie wszystkich celów odwiedzającego
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"
    }
  ]
}