Calcolare la disponibilità operativa
Intervallo inclusivo sulle partenze UTC. Può materializzare l'inventario ricorrente. Nessuna quotazione prezzi: leggere pricing-periods; il totale autorevole della prenotazione è pricingSnapshot. Questa API management ignora il booking cutoff nel flag available, ma POST bookings con startAt lo applica. Non riserva capacità.
/api/v1/availabilityAuthorization
Query
curl "https://api.takoconnect.com/api/v1/availability" \
-H "Authorization: Bearer $TAKO_API_KEY"[
{
"optionId": "option-id",
"startAt": "2030-06-15T08:00:00.000Z",
"endAt": "2030-06-15T08:00:00.000Z",
"cutoffAt": "2030-06-15T08:00:00.000Z",
"maxUnits": 0,
"manual": true,
"available": true,
"capacity": 0,
"vacancies": 0,
"resources": [
{
"resourceId": "resource-id",
"vacancies": 0
}
]
}
]Autorizzazione
AuthorizationBearer <token>
Chiave tenant emessa dalla dashboard o da POST /api-keys, usata come Bearer token.
Scope richiesti: availability:read
In: header
Query
optionIdstring
minLength 1
fromdatetime
date-time
todatetime
date-time
Risposte
200object[]
Operazione riuscita. Lo schema descrive il JSON restituito.
Mostra schema
optionIdstring
startAtdatetime
date-time
endAtdatetime | null
date-time
cutoffAtdatetime
date-time
maxUnitsinteger | null
manualboolean
availableboolean
capacityinteger | null
vacanciesinteger | null
resources?object[]
Mostra proprietà
resourceIdstring
vacanciesinteger
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.