Creare un fornitore

reference opzionale, derivata dal nome e univoca nel tenant. Se esplicita e già usata: 409. locale predefinito it-IT. Usare un fuso IANA, per esempio Europe/Rome.

https://api.takoconnect.com

POST/api/v1/suppliers

Authorization

Bearer chiave tenant

Body

curl -X POST "https://api.takoconnect.com/api/v1/suppliers" \
  -H "Authorization: Bearer $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Operatore",
  "timezone": "Europe/Rome",
  "locale": "it-IT"
}'

{
  "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:write

In: header

Body

Content-Type: application/json

namestring

minLength 1

reference?string

timezonestring

minLength 1

locale?string

Default "it-IT"minLength 2

website?string | null

uri

email?string | null

telephone?string | null

minLength 1

address?string | null

minLength 1

metadata?object

Risposte

201object

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.

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.

SuccessivoLeggere un fornitoreGET