TracePass
Inizia ora
Verifica dell'ambito DPP

Avvia un'esecuzione del catalogo

Avvia una nuova esecuzione dell'ambito del catalogo che ri-controlla l'intero catalogo rispetto alle regole correnti. L'esecuzione si mette in coda immediatamente ed è asincrona; la risposta è 202 con un `runId` da monitorare. Il catalogo si aggiorna automaticamente anche ogni notte.

POST/api/v1/scope/catalogue/runs
Scarica OpenAPI 3.1
POST/api/v1/scope/catalogue/runs

Avvia un'esecuzione del catalogo

Avvia una nuova esecuzione dell'ambito del catalogo che ri-controlla l'intero catalogo rispetto alle regole correnti. L'esecuzione si mette in coda immediatamente ed è asincrona; la risposta è 202 con un `runId` da monitorare. Il catalogo si aggiorna automaticamente anche ogni notte.

Richiede Growth o superiore. Idempotency-Key è rispettato: riutilizzate la stessa chiave entro 24 ore per recuperare l'esecuzione originale. 409 `run_in_progress` quando un'esecuzione è già in corso. 429 `run_cooldown` con `retryAfter` se un'esecuzione è finita meno di 10 minuti fa.

Header

  • Authorizationobbligatorio

    string

    `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4 per richiesta di esecuzione logica. Riutilizzo entro 24 ore restituisce la stessa esecuzione.

Richiesta

curl -sS -X POST https://app.tracepass.eu/api/v1/scope/catalogue/runs \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Idempotency-Key: 7b4f1e2c-9a3d-4e5b-8c1a-2d3e4f5a6b7c"

Risposta

{ "runId": "6acbb533c5553f06d833479e", "status": "queued" }

Endpoint correlati