v0.9.1

suppliers

Salvare i widget della dashboard di un fornitore

dashboardLayout: [{ id, size: small|large|big }] in ordine, max 30; null = predefinito. Condiviso dagli utenti del fornitore; non genera audit né eventi prodotto.


https://api.takoconnect.com
PUT/api/v1/suppliers/{id}/dashboard-layout
Authorization
Path
Body
curl -X PUT "https://api.takoconnect.com/api/v1/suppliers/{id}/dashboard-layout" \
  -H "Authorization: Bearer $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dashboardLayout": [
    {
      "id": "today",
      "size": "large"
    }
  ]
}'
{
  "id": "entity-id",
  "tenantId": "tenant-id",
  "name": "name",
  "reference": "tour-di-esempio",
  "createdAt": "2030-06-15T08:00:00.000Z",
  "updatedAt": "2030-06-15T08:00:00.000Z",
  "timezone": "timezone",
  "locale": "locale",
  "website": "website",
  "email": "email",
  "telephone": "telephone",
  "address": "address",
  "metadata": {},
  "dashboardLayout": [
    {
      "id": "entity-id",
      "size": "small"
    }
  ],
  "deletedAt": "2030-06-15T08:00:00.000Z"
}

Autorizzazione

AuthorizationBearer <token>

Chiave tenant emessa dalla dashboard o da POST /api-keys, usata come Bearer token.

Scope richiesti: suppliers:write

In: header

Parametri di percorso

idstring

Body

Content-Type: application/json

dashboardLayoutobject[] | null

Mostra proprietà

idstring

minLength 1

sizeenum

smalllargebig

Risposte

200object

Operazione riuscita. Lo schema descrive il JSON restituito.

Mostra schema

idstring

tenantIdstring

namestring

referencestring

createdAtdatetime

date-time

updatedAtdatetime

date-time

timezonestring

localestring

websitestring | null

emailstring | null

telephonestring | null

addressstring | null

metadataany

Valore JSON libero; non usare per dedurre campi strutturati non documentati.

dashboardLayoutobject[] | null

Mostra proprietà

idstring

sizeenum

smalllargebig

deletedAtdatetime | null

date-time

400object

Validazione o regola di dominio non soddisfatta; correggere la richiesta.

401object

Credenziale assente, revocata, scaduta o non valida.

403object

Scope, ruolo o tipo di credenziale non consentito.

404object

Risorsa assente o non accessibile nel perimetro risolto.

409object

Conflitto di stato, capacità, versione o riferimenti; rileggere lo stato e correggere.

413object

Corpo JSON oltre il limite di 15 MB.

500object

Errore interno. Prima di ripetere una mutazione verificarne l'esito.

SuccessivoElencare il catalogo completoGET