v0.9.1

channels

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.


https://api.takoconnect.com
POST/api/v1/channels/{code}/connect
Authorization
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.

SuccessivoLeggere gli ultimi job di sincronizzazioneGET