Attività · documentazione TradeCatalog

Attività

Il registro delle attività dello spazio di lavoro di chi ha modificato clienti, sconti e prezzi, più recenti per primi.

TradeCatalog registra una riga in linguaggio naturale per ogni modifica del personale ai clienti, sconti e prezzi. Le modifiche effettuate tramite l'API vengono registrate con il nome della chiave, ad esempio API key “Sage stock sync”.

Elenco attivitàCollegamento a questa sezione#

GET/api/v1/activity

Più recenti per primi. Passa customer per la cronologia di un solo cliente.

Nome	Tipo	Obbligatorio	Descrizione
`customer`	stringa	no	ID cliente o codice account.
`limit`	intero	no	1 a 100. Valore predefinito 100.
`type`	stringa	no	Tipo di registro, ad esempio ordine, cliente o sicurezza.
`before`	stringa	no	ISO dell'ultimo elemento `createdAt`, per recuperare elementi più vecchi.
`beforeId`	stringa	no	Ultimo elemento `id`, abbinato a `before` per includere elementi con lo stesso orario.

Vai indietro usando sia before che beforeId dall'ultima voce restituita. Una pagina vuota significa che non ci sono voci più vecchie che corrispondono ai tuoi filtri.

Solo una chiave creata da un proprietario o admin vede l'intero registro; per chiunque altro elenca solo le modifiche relative ai clienti che può vedere.

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
    }
  ]
}

Campo	Tipo	Descrizione
`actorName`	stringa	Chi ha effettuato la modifica. Conservato anche se quella persona lascia in seguito.
`summary`	stringa	Cosa è cambiato, in linguaggio naturale. Destinato alle persone, non al parsing.
`createdAt`	stringa	Quando.
`customerAccountId`	stringa o null	Il cliente a cui si riferiva, se presente.
`customerName`	stringa o null	Il nome attuale di quel cliente.

I cambiamenti dello stato dell'ordine hanno un riepilogo delle attività dello spazio di lavoro e una cronologia dettagliata in ogni ordine events. Consulta Ordini.

Nuovi eventi possono includere anche action, outcome e source. Gli eventi più vecchi possono lasciare questi campi vuoti. Un'esportazione generata è prova che TradeCatalog ha preparato il file, non che qualcuno lo ha salvato. Una richiesta di checkout è separata da un pagamento confermato dal provider di pagamento. I dettagli grezzi dell'IP e del browser non sono inclusi in questa API. Gli eventi di sicurezza del personale richiedono accesso owner/admin; gli eventi collegati ai clienti seguono lo scope del cliente.