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.
/api/v1/resources/{id}/inventoryAuthorization
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.