Aktivität · TradeCatalog-Dokumentation

Aktivität

Der Aktivitätsprotokoll des Arbeitsbereichs, wer Kunden, Rabatte und Preise geändert hat, am neuesten zuerst.

TradeCatalog protokolliert eine einfache Textzeile für jede Änderung von Mitarbeitern bei Kunden, Rabatten und Preisen. Änderungen, die über die API vorgenommen werden, werden unter dem Namen des Schlüssels protokolliert, z. B. API key “Sage stock sync”.

AktivitätslisteLink zu diesem Abschnitt#

GET/api/v1/activity

Neueste zuerst. Geben Sie customer an, um die Geschichte eines Kunden anzuzeigen.

Name	Type	Required	Beschreibung
`customer`	string	nein	Kunden-ID oder Kontocode.
`limit`	integer	nein	1 bis 100. Standardwert 100.
`type`	string	nein	Datensatztyp, z. B. Auftrag, Kunde oder Sicherheit.
`before`	string	nein	ISO-Code des letzten Eintrags `createdAt`, um ältere Einträge abzurufen.
`beforeId`	string	nein	Letzter Eintrag's `id`, in Kombination mit `before`, um Einträge zum gleichen Zeitstempel einzuschließen.

Gehen Sie mit beiden before und beforeId vom letzten zurückgegebenen Eintrag zurück. Eine leere Seite bedeutet, dass es keine älteren Einträge gibt, die Ihren Filtern entsprechen.

Nur ein Schlüssel, der von einem Besitzer oder Administrator erstellt wurde, sieht den gesamten Protokoll; für andere werden nur Änderungen angezeigt, die sich auf Kunden beziehen, die sie sehen können.

bash

curl "https://tradecatalog.app/api/v1/activity?customer=OAK01&limit=20" \
  -H "Authorization: Bearer $TRADECATALOG_API_KEY"

const res = await fetch(
  'https://tradecatalog.app/api/v1/activity?customer=OAK01&limit=20',
  {
    headers: { Authorization: `Bearer ${process.env.TRADECATALOG_API_KEY}` },
  },
)
const { data: entries } = await res.json()

json

{
  "data": [
    {
      "id": "d0e1f2a3-b4c5-4d6e-8f7a-9b0c1d2e3f4a",
      "actorName": "Jo Hartley",
      "summary": "Set Northgate brand discount to 15% (was 12.5%)",
      "createdAt": "2026-09-26T14:21:03.000Z",
      "customerAccountId": "7d2e4f0a-1b3c-4d5e-8f90-a1b2c3d4e5f6",
      "customerName": "Oakfield Joinery"
    },
    {
      "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
      "actorName": "API key “Sage stock sync”",
      "summary": "Imported customers: 0 new, 42 updated",
      "createdAt": "2026-09-26T02:00:09.000Z",
      "customerAccountId": null,
      "customerName": null
    }
  ]
}

Feld	Typ	Beschreibung
`actorName`	string	Wer hat die Änderung vorgenommen. Wird auch gespeichert, wenn diese Person später geht.
`summary`	string	Was geändert wurde, in einfacher Sprache. Für Menschen, nicht für Parsing.
`createdAt`	string	Wann.
`customerAccountId`	string oder null	Der Kunde, auf den sich die Änderung bezieht, falls vorhanden.
`customerName`	string oder null	Der aktuelle Name dieses Kunden.

Änderungen des Bestellstatus haben eine Arbeitsbereichsaktivitätszusammenfassung und detaillierte Geschichte in jedem Bestell-events. Siehe Bestellungen.

Neue Ereignisse können auch action, outcome und source enthalten. Ältere Ereignisse können diese Felder leer lassen. Eine generierte Exportdatei ist Beweis dafür, dass TradeCatalog die Datei vorbereitet hat, nicht dass jemand sie gespeichert hat. Ein Checkout-Antrag ist separat von einer Zahlung, die vom Zahlungsanbieter bestätigt wurde. Rohdaten zu IP-Adresse und Browser werden von dieser API ausgeschlossen. Sicherheitsereignisse von Mitarbeitern erfordern Besitzer/Administrator-Zugriff; kundengebundene Ereignisse folgen dem Kundenumfang.