API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · analytics_datasources

Analytics Datasource

Schema-ID
analytics_datasource
Collection
analytics_datasources
Permissions
  • Lesenanalytics_datasource_view
  • Anlegenanalytics_datasource_create
  • Ändernanalytics_datasource_edit
  • Löschenanalytics_datasource_delete

Felder

Analytics Datasource

analytics_datasources4 Permissions
namestringerforderlich
1–200 Zeichen
descriptionstringoptional
max 2000 Zeichennullable
typestringerforderlich
Werte
postgresqlmysqlmssqlrest_apicsvexcelgoogle_sheets
connectionConfigobjectoptional

Connection parameters (host, port, database, URL, ...). Secret-named fields (password, apiKey, token, bearerToken, accessToken, refreshToken, privateKey, clientSecret, secret) are transparently encrypted at rest using AES-256-GCM via ANALYTICS_DATASOURCE_KEY. API responses mask these fields as "***".

nullable
syncIntervalstringoptional
Werte
manualhourlydailyweekly
Default: "daily"
syncCronstringoptional

Optional 5-field cron expression overriding syncInterval. Evaluated in UTC. When set, the scheduler uses this instead of the interval preset.

max 100 Zeichennullable
lastSyncAtdatetimeoptional
read-onlynullable
lastSyncStatusstringoptional
Werte
successerrorrunning
read-onlynullable
lastSyncErrorstringoptional
max 2000 Zeichenread-onlynullable
lastSyncDurationMsintegeroptional
≥ 0read-onlynullable
nextSyncAtdatetimeoptional
read-onlynullable
schemaMappingobject[]optional
Default: []nullable
transformRulesobject[]optional
Default: []nullable
isActivebooleanoptional
Default: true
cachedRowCountintegeroptional
≥ 0read-onlynullable
uploadMetadataobjectoptional

CSV/Excel-only: metadata about the latest uploaded file (Phase B). Filled by the upload-complete handler and consumed by the ingest job.

read-onlynullable
fileKeystringoptional
originalFileNamestringoptional
rowCountintegeroptional
≥ 0
columnSamplestring[]optional
delimiterstringoptional
encodingstringoptional
hasHeaderbooleanoptional

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/analytics_datasources — Liste, paginiert + filterbar
  • GET /api/v1/analytics_datasources/<id> — Einzelne Entity
  • POST /api/v1/analytics_datasources — Anlegen
  • PATCH /api/v1/analytics_datasources/<id> — Teil-Update
  • DELETE /api/v1/analytics_datasources/<id> — Soft-Delete
  • GET /api/v1/analytics_datasources/<id>/timeline — Audit + Aktivitäten

Suche