scango.ch API

API REST clienti di scango.ch.

Autenticazione con Authorization: Bearer <api-key> (chiave Read o Write). Gli importi sono interi in centesimi. Gli elenchi restituiscono { data, meta }.

L’API è pensata per chiamate da server a server. I browser possono chiamarla solo da questa documentazione (Prova). I body delle richieste sono JSON (max. 1 MB), salvo diversa indicazione dell’operazione. I parametri data-ora devono essere in UTC ISO-8601 con suffisso Z (2024-01-01T00:00:00.000Z).

Gli errori hanno la forma { statusCode, message, timestamp, path }. Ogni errore di autenticazione o autorizzazione (chiave mancante, sconosciuta o inattiva, oppure chiave Read su un’operazione di scrittura) restituisce 403. Un metodo non supportato restituisce 405 con header Allow.

Prodotti

Catalogo prodotti

• GET
  Elenca o cerca prodotti/products
• POST
  Crea prodotto/products
• GET
  Ottieni prodotto per ID/products/{productId}
• POST
  Aggiorna prodotto/products/{productId}
• DELETE
  Elimina prodotto/products/{productId}
• POST
  Carica immagine prodotto/products/{productId}/image
• DELETE
  Elimina immagine prodotto/products/{productId}/image

Ordini

Ordini

• GET
  Elenca ordini/orders
• GET
  Ottieni ordine per ID/orders/{orderId}

Fornitori

Fornitori

• GET
  Elenca fornitori/suppliers
• POST
  Crea fornitore/suppliers
• GET
  Ottieni fornitore per ID/suppliers/{supplierId}
• POST
  Aggiorna fornitore/suppliers/{supplierId}
• DELETE
  Elimina fornitore/suppliers/{supplierId}

Categorie

Categorie

• GET
  Elenca categorie/categories
• POST
  Crea categoria/categories
• GET
  Ottieni categoria per ID/categories/{categoryId}
• POST
  Aggiorna categoria/categories/{categoryId}
• DELETE
  Elimina categoria/categories/{categoryId}

Negozi

Negozi

• GET
  Elenca negozi/stores
• POST
  Crea negozio/stores
• GET
  Ottieni negozio per ID/stores/{storeId}
• POST
  Aggiorna negozio/stores/{storeId}
• DELETE
  Elimina negozio/stores/{storeId}

Log di identità

Log di verifica dell’identità e identità bloccate. Disponibile solo quando la funzione identity-logs è abilitata per l’organizzazione.

• GET
  Elenca i log di identità/identity-logs
• GET
  Ottieni un log di identità per id/identity-logs/{logId}
• GET
  Elenca le identità bloccate/identity-logs/blocked
• POST
  Blocca identità/identity-logs/blocked
• POST
  Aggiorna identità bloccata/identity-logs/blocked/{blockedId}
• DELETE
  Elimina identità bloccata/identity-logs/blocked/{blockedId}