Attivare o riattivare un canale per un fornitore
Upsert per tenant, supplierId e canale. Se non esiste una chiave non revocata viene restituita defaultApiKey; altrimenti il campo è assente. configuration e credentials sono specifici del canale. Ometterli mantiene i valori precedenti.
/api/v1/channels/{code}/connectAuthorization
Path
Body
curl -X POST "https://api.takoconnect.com/api/v1/channels/{code}/connect" \
-H "Authorization: Bearer $TAKO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"supplierId": "supplier-id"
}'{
"id": "entity-id",
"tenantId": "tenant-id",
"supplierId": "supplier-id",
"channelId": "channel-id",
"status": "ACTIVE",
"configuration": {},
"createdAt": "2030-06-15T08:00:00.000Z",
"updatedAt": "2030-06-15T08:00:00.000Z",
"channel": {
"code": "code",
"name": "name",
"type": "type"
},
"defaultApiKey": {
"id": "entity-id",
"name": "name",
"prefix": "prefix",
"scopes": [
"scopes"
],
"supplierId": "supplier-id",
"createdAt": "2030-06-15T08:00:00.000Z",
"lastUsedAt": "2030-06-15T08:00:00.000Z",
"expiresAt": "2030-06-15T08:00:00.000Z",
"revokedAt": "2030-06-15T08:00:00.000Z",
"key": "key"
}
}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
codestring
Body
Content-Type: application/json
supplierIdstring
minLength 1
credentials?object
configuration?object
Risposte
201object
Operazione riuscita. Lo schema descrive il JSON restituito.
Mostra schema
idstring
tenantIdstring
supplierIdstring
channelIdstring
statusenum
ACTIVEDISABLED
configurationany
Valore JSON libero; non usare per dedurre campi strutturati non documentati.
createdAtdatetime
date-time
updatedAtdatetime
date-time
channelobject
Mostra proprietà
codestring
namestring
typestring
defaultApiKey?object
Mostra proprietà
idstring
namestring
prefixstring
scopesstring[]
supplierIdstring | null
Fornitore a cui la chiave è limitata; null = tutto il tenant.
createdAtdatetime
date-time
lastUsedAtdatetime | null
date-time
expiresAtdatetime | null
date-time
revokedAtdatetime | null
date-time
keystring
Segreto restituito una sola volta alla creazione. Conservarlo prima di chiudere la risposta.
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.