Elencare i fornitori
Senza limit restituisce un array. Con limit (1–100) restituisce {items,total}; offset parte da 0 ed è ignorato senza limit. Non è un cursore di sincronizzazione. Esclude i fornitori archiviati; ordine per nome.
/api/v1/suppliersAuthorization
Query
curl "https://api.takoconnect.com/api/v1/suppliers" \
-H "Authorization: Bearer $TAKO_API_KEY"[
{
"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": {},
"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:read
In: header
Query
limit?integer
min 1max 100
offset?integer
min 0
Risposte
200object[] | object
Operazione riuscita. Lo schema descrive il JSON restituito.
Mostra schema
Variante 1
itemsobject[]
Mostra proprietà
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.
deletedAtdatetime | null
date-time
totalinteger
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.
500object
Errore interno. Prima di ripetere una mutazione verificarne l'esito.