v0.3.0

inventory

Impostare la capacità degli slot

Upsert per (resourceId,startAt). Specificare capacity (posti totali) oppure quantity (numero risorse), mai entrambi; senza entrambi ripristina la capacità del pool. Non modifica reserved. endAt, se presente, deve essere dopo startAt. 409 sotto il riservato. Non inviare la disponibilità residua come capacità totale.


https://api.takoconnect.com
POST/api/v1/resources/{id}/inventory
Authorization
Path
Body
curl -X POST "https://api.takoconnect.com/api/v1/resources/{id}/inventory" \
  -H "Authorization: Bearer $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "slots": [
    {
      "startAt": "2030-06-15T08:00:00Z",
      "capacity": 10
    }
  ]
}'
[
  {
    "id": "entity-id",
    "tenantId": "tenant-id",
    "resourceId": "resource-id",
    "startAt": "2030-06-15T08:00:00.000Z",
    "endAt": "2030-06-15T08:00:00.000Z",
    "capacity": 0,
    "reserved": 0,
    "createdAt": "2030-06-15T08:00:00.000Z",
    "updatedAt": "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: resources:write

In: header

Parametri di percorso

idstring

Body

Content-Type: application/json

slotsobject[]

Mostra proprietà

startAtdatetime

date-time

endAt?datetime

date-time

capacity?integer

min 0

quantity?integer

min 0

Risposte

201object[]

Operazione riuscita. Lo schema descrive il JSON restituito.

Mostra schema

idstring

tenantIdstring

resourceIdstring

startAtdatetime

date-time

endAtdatetime | null

date-time

capacityinteger

reservedinteger

createdAtdatetime

date-time

updatedAtdatetime

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 gli slot inventarioGET