v0.10.0

calendar

Scegliere il calendario o l'import degli impegni occupati

calendarId sceglie il calendario su cui Tako lavora (uno di GET …/calendars): le prenotazioni CONFIRMED/PENDING future del fornitore vengono scritte lì in modo asincrono e da lì ogni modifica segue; cambiandolo, gli eventi già scritti sul calendario precedente restano. Con importBusy gli impegni occupati del calendario scelto chiudono i prodotti attivi del fornitore (blocchi con calendarConnectionId, aggiornati ogni 5 minuti); importBusy false rimuove subito i blocchi importati.


https://api.takoconnect.com
PATCH/api/v1/calendar/connections/{id}
Authorization
Path
Body
curl -X PATCH "https://api.takoconnect.com/api/v1/calendar/connections/{id}" \
  -H "Authorization: Bearer $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "calendarId": "primary"
}'
{
  "id": "entity-id",
  "tenantId": "tenant-id",
  "supplierId": "supplier-id",
  "provider": "provider",
  "accountEmail": "accountEmail",
  "calendarId": "calendar-id",
  "importBusy": true,
  "status": "ACTIVE",
  "lastSyncedAt": "2030-06-15T08:00:00.000Z",
  "lastError": "lastError",
  "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: channels:write

In: header

Parametri di percorso

idstring

Body

Content-Type: application/json

importBusy?boolean

calendarId?string

minLength 1

Risposte

200object

Operazione riuscita. Lo schema descrive il JSON restituito.

Mostra schema

idstring

tenantIdstring

supplierIdstring

providerstring

accountEmailstring | null

calendarIdstring | null

Il calendario Google su cui Tako lavora; null finché non viene scelto.

importBusyboolean

statusenum

ACTIVEDISABLED

lastSyncedAtdatetime | null

date-time

lastErrorstring | null

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.

SuccessivoScollegare il calendarioDELETE