Creare un'unità prenotabile
reference generata dal nome. Le tariffe UNIT/RESOURCE esistenti ricevono una voce a prezzo zero: aggiornare i prezzi prima di vendere. RESOURCE usa metadata.resourceId; restrictions.paxCount indica i posti per unità.
/api/v1/options/{id}/unitsAuthorization
Path
Body
curl -X POST "https://api.takoconnect.com/api/v1/options/{id}/units" \
-H "Authorization: Bearer $TAKO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "ADULT",
"name": "Adulto",
"restrictions": {
"paxCount": 1
}
}'{
"id": "entity-id",
"tenantId": "tenant-id",
"name": "name",
"reference": "tour-di-esempio",
"createdAt": "2030-06-15T08:00:00.000Z",
"updatedAt": "2030-06-15T08:00:00.000Z",
"optionId": "option-id",
"type": "ADULT",
"requiredContactFields": [
"requiredContactFields"
],
"restrictions": {},
"metadata": {},
"deletedAt": "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: catalog:write
In: header
Parametri di percorso
idstring
Body
Content-Type: application/json
typeenum
ADULTYOUTHCHILDINFANTFAMILYSENIORSTUDENTMILITARYOTHER
namestring
minLength 1
requiredContactFields?enum[]
restrictions?object
Mostra proprietà
minAge?integer
min 0
maxAge?integer
min 0
idRequired?boolean
minQuantity?integer | null
min 0
maxQuantity?integer | null
min 0
paxCount?integer
min 0
accompaniedBy?string[]
metadata?object
Risposte
201object
Operazione riuscita. Lo schema descrive il JSON restituito.
Mostra schema
idstring
tenantIdstring
namestring
referencestring
createdAtdatetime
date-time
updatedAtdatetime
date-time
optionIdstring
typeenum
ADULTYOUTHCHILDINFANTFAMILYSENIORSTUDENTMILITARYOTHER
requiredContactFieldsstring[]
restrictionsany
Valore JSON libero; non usare per dedurre campi strutturati non documentati.
metadataany
Valore JSON libero; non usare per dedurre campi strutturati non documentati.
deletedAtdatetime | null
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.