API-referentie

De Tidal Control API geeft je programmatische toegang tot de gegevens van je organisatie. Gebruik hem om data te exporteren voor rapportages, te koppelen aan andere tools of om eigen dashboards te bouwen.

Endpoint: https://portal.tidalcontrol.com/graphql

Protocol: GraphQL over HTTPS. Alle verzoeken zijn POST met een JSON-body.

10 artikelen

Authenticatie

Authenticatie met de Tidal Control API. De OAuth 2.0 Device Authorization Grant voor scripts en CLI-tools, plus read-only machine-to-machine-credentials.

Data opvragen

De patronen voor paginering, filtering en sortering die elke lijstquery in de Tidal Control API deelt. Leer ze eenmalig, plus records tellen en foutafhandeling.

Risico's exporteren

Exporteer risico's uit de Tidal Control API met de risks_paged-query, inclusief kans, impact en restscores, behandelbeslissingen en gekoppelde maatregelen.

Maatregelen exporteren

Exporteer maatregelen uit de Tidal Control API met de controls_paged-query, met categorie, effectiviteitsstatus, gekoppelde risico's en raamwerkreferenties.

Middelen exporteren

Exporteer middelen uit de Tidal Control API met de assets_paged-query, inclusief CIA-scores, gekoppelde maatregelen, risico's en informatietypen, met Python.

Issues exporteren

Exporteer issues uit de Tidal Control API met de issues_paged-query. Bevindingen, hiaten, incidenten en actieplannen gekoppeld aan maatregelen en middelen.

Taken exporteren

Exporteer taken en beoordelingen uit de Tidal Control API met activities_paged en een activityTypes-filter, met inline fragments voor beoordelingsvelden.

Rapportage use cases

Bouw de rapporten die compliance teams nodig hebben met de Tidal Control API. Maatregeleffectiviteit per periode, verlopen maatregelen en gecombineerde status.

Schema-introspectie

Ontdek met GraphQL-introspectie welke queries, mutations, types en velden de Tidal Control API biedt, en inspecteer een mutation voordat je hem aanroept.

Bewijs toevoegen

Schrijf data weg met de Tidal Control GraphQL API. Upload een bewijsbestand, maak een uitvoeringstaak op een maatregel aan en koppel het bestand, met Python.