v0.3.0

sync jobs

Leggere gli ultimi job di sincronizzazione

Massimo 200, createdAt decrescente; tentativi ordinati per numero. Non è una lista completa paginabile.


https://api.takoconnect.com
GET/api/v1/sync-jobs
Authorization
Query
curl "https://api.takoconnect.com/api/v1/sync-jobs" \
  -H "Authorization: Bearer $TAKO_API_KEY"
[
  {
    "id": "entity-id",
    "tenantId": "tenant-id",
    "supplierId": "supplier-id",
    "channelConnectionId": "channel-connection-id",
    "provider": "provider",
    "type": "type",
    "entityId": "entity-id",
    "dedupKey": "dedupKey",
    "status": "PENDING",
    "correlationId": "correlation-id",
    "createdAt": "2030-06-15T08:00:00.000Z",
    "startedAt": "2030-06-15T08:00:00.000Z",
    "completedAt": "2030-06-15T08:00:00.000Z",
    "attempts": [
      {
        "id": "entity-id",
        "syncJobId": "sync-job-id",
        "attempt": 0,
        "status": "status",
        "errorCode": "errorCode",
        "errorMessage": "errorMessage",
        "requestMetadata": {},
        "responseMetadata": {},
        "createdAt": "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: sync:read

In: header

Query

status?enum

PENDINGRUNNINGRETRYINGSUCCEEDEDFAILED

provider?string

supplierId?string

Risposte

200object[]

Operazione riuscita. Lo schema descrive il JSON restituito.

Mostra schema

idstring

tenantIdstring

supplierIdstring | null

channelConnectionIdstring

providerstring

typestring

entityIdstring | null

dedupKeystring | null

statusenum

PENDINGRUNNINGRETRYINGSUCCEEDEDFAILED

correlationIdstring | null

createdAtdatetime

date-time

startedAtdatetime | null

date-time

completedAtdatetime | null

date-time

attemptsobject[]

Mostra proprietà

idstring

syncJobIdstring

attemptinteger

statusstring

errorCodestring | null

errorMessagestring | null

requestMetadataany

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

responseMetadataany

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

createdAtdatetime

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.

500object

Errore interno. Prima di ripetere una mutazione verificarne l'esito.

SuccessivoAccodare un nuovo tentativo per un job FAILEDPOST