v0.3.0

availability periods

Aggiungere disponibilità ricorrente

Ricorrenza annuale nel fuso del prodotto, altrimenti del fornitore. Date MM-DD inclusive, anche a cavallo d'anno; weekdays: 0 domenica–6 sabato; startTimes: HH:mm. Serve almeno una risorsa collegata. Non configura i prezzi: completare pricing-periods prima di vendere.


https://api.takoconnect.com
POST/api/v1/options/{id}/availability-periods
Authorization
Path
Body
curl -X POST "https://api.takoconnect.com/api/v1/options/{id}/availability-periods" \
  -H "Authorization: Bearer $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "startMonthDay": "01-01",
  "endMonthDay": "12-31",
  "weekdays": [
    0,
    1,
    2,
    3,
    4,
    5,
    6
  ],
  "startTimes": [
    "10:00"
  ]
}'
{
  "id": "entity-id",
  "tenantId": "tenant-id",
  "optionId": "option-id",
  "startMonthDay": "startMonthDay",
  "endMonthDay": "endMonthDay",
  "weekdays": [
    0
  ],
  "startTimes": [
    "startTimes"
  ],
  "label": "label",
  "createdAt": "2030-06-15T08:00:00.000Z",
  "updatedAt": "2030-06-15T08:00:00.000Z",
  "active": true,
  "pricingBasis": "pricingBasis",
  "currency": "EUR",
  "prices": {}
}

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

startMonthDaystring

endMonthDaystring

weekdaysinteger[]

startTimesstring[]

label?string

Risposte

201object

Operazione riuscita. Lo schema descrive il JSON restituito.

Mostra schema

idstring

tenantIdstring

optionIdstring

startMonthDaystring

endMonthDaystring

weekdaysinteger[]

startTimesstring[]

labelstring | null

createdAtdatetime

date-time

updatedAtdatetime

date-time

activeboolean

pricingBasisstring

Campo legacy; leggere i prezzi da pricing-periods.

currencystring

Campo legacy; la valuta corrente è tenant.defaultCurrency.

pricesany

Valore JSON libero; non usare per dedurre campi strutturati non documentati.

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.

SuccessivoDisattivare un periodo di disponibilitàDELETE