Dieses Register beschreibt Abruf, Datenstrukturen, Datenformate und Normen des Exports nach den Informationen nach dem Data Act. Es umfasst die dort aufgeführten exportierbaren Daten und digitalen Vermögenswerte.
Abruf
Der Kunde fordert den Export nach Abschnitt 13 der Nutzungsbedingungen an und kann dabei Zielanbieter benennen. Bytekontor stellt den Export als ZIP-Archiv bereit und übermittelt dem Kunden und jedem benannten Zielanbieter einen eigenen, geheimen HTTPS-Link. Eine einfache GET-Anfrage an diesen Link liefert das Archiv (application/zip); weitere Authentifizierung ist nicht erforderlich. Die Gültigkeit des Links steht in der Bereitstellungsnachricht. Kunden können den Export wiederholt anfordern.
Archivaufbau
| Datei | Format | Inhalt |
|---|---|---|
manifest.json |
JSON | Formatversion, Erstellungszeitpunkt und Dateiliste |
account.json |
JSON | Kundenkonto, Agentenverbindungen und Dashboard-Sitzungen |
apps.json |
JSON | Apps und ihre Konfiguration |
faqs.json |
JSON | FAQs mit Übersetzungen |
feature_plans.json |
JSON | Feature Plans |
alerts.json |
JSON | Alerts mit Übersetzungen und Filtern |
app_users.jsonl |
JSON Lines | Pseudonyme Endnutzer |
devices.jsonl |
JSON Lines | Installationen der Endnutzer |
votes.jsonl |
JSON Lines | Abstimmungen |
activities.jsonl |
JSON Lines | Monatliche Aktivität der Endnutzer |
agent_writes.jsonl |
JSON Lines | Ergebnisse von Schreibanfragen verbundener Agenten |
logs.jsonl |
JSON Lines | Kundenbezogene Anfrage-, Fehler- und Sicherheitsdaten |
icons/<app_id>.<Endung> |
Originalformat | App-Icons |
manifest.json und account.json enthalten ein Objekt, die übrigen JSON-Dateien ein Array von Objekten und JSON-Lines-Dateien ein Objekt je Zeile. Fehlt ein Wert, ist das Feld null. id und Verweise auf Datensätze anderer Dateien (app_id, app_user_id, feature_plan_id, oauth_connection_id) sind ganze Zahlen. Felder mit der Endung _at sind Zeitpunkte, month ist ein Kalendermonat als Datum seines ersten Tages.
Datenstrukturen
manifest.json
format_version (Zahl), created_at und files (Array mit path, bytes und sha256 je Datei).
account.json
| Feld | Typ | Inhalt |
|---|---|---|
email_address, name |
Text | Kontoangaben |
created_at, email_verified_at |
Zeitpunkt | Registrierung und E-Mail-Bestätigung |
plan, subscription_status |
Text | Tarif (free, green, blue) und Abonnementstatus |
trial_ends_at, subscription_cancel_at |
Zeitpunkt | Testende und vorgemerkte Kündigung |
scheduled_plan, scheduled_plan_change_at |
Text, Zeitpunkt | Vorgemerkter Tarifwechsel |
mau_tracking_started_at |
Zeitpunkt | Beginn der MAU-Zählung |
stripe_customer_id, stripe_subscription_id |
Text | Referenzen beim Zahlungsdienstleister |
oauth_connections |
Array | Verbundene Agenten: id, application_name, scopes (Array), app_ids (Array), created_at, expires_at, revoked_at |
sessions |
Array | Dashboard-Sitzungen: created_at, updated_at, ip_address, user_agent |
apps.json
id, title, website_url, feature_plans_deep_link_url, icon (Pfad im Archiv oder null), created_at, updated_at.
faqs.json
id, app_id, title, body (Text), status (draft, live, archived), position (Zahl), created_at, updated_at und localizations (Array mit locale, title, body).
feature_plans.json
id, app_id, title, body (Text), status (open, under_review, planned, in_progress, completed, closed), initial_score und voted_score (Zahlen), created_at, updated_at.
alerts.json
id, app_id, title, message, kind (error, warning), status (draft, live, archived), targeting (broadcast, filtered oder null), debug_mode (Wahrheitswert), occurred_at, went_live_at, created_at, updated_at, localizations (Array mit locale, title, message) und filter (Objekt mit den Text-Arrays ios_app_versions, ios_os_versions, android_app_versions, android_os_versions oder null).
app_users.jsonl
id, app_id, identifiers (Array der vom SDK übermittelten anonymen und externen Kennungen), created_at, updated_at.
devices.jsonl
app_user_id, device_id, os_name, os_version, app_version, app_build_version, device_model, language_code (alle Text), created_at, updated_at.
votes.jsonl
app_user_id, feature_plan_id, created_at, updated_at.
activities.jsonl
app_user_id, month.
agent_writes.jsonl
oauth_connection_id, request_id, created_at und result (Objekt mit der Antwort auf die Schreibanfrage).
logs.jsonl
| Feld | Typ | Inhalt |
|---|---|---|
timestamp |
Zeitpunkt | Zeitpunkt des Ereignisses |
source |
Text | request, error oder security |
app_id |
Zahl | Betroffene App oder null bei Kontoereignissen |
method, path |
Text | HTTP-Methode und Pfad |
params |
Objekt | Anfrageparameter einschließlich Suchbegriffen; vertrauliche Werte sind durch [FILTERED] ersetzt |
status |
Zahl | HTTP-Statuscode |
ip_address, user_agent |
Text | Absenderangaben |
message |
Text | Fehler- oder Ereignisbeschreibung |
Nicht in der Quelle gespeicherte Felder sind null. Der Umfang richtet sich nach den Aufbewahrungsfristen der Datenschutzerklärung.
App-Icons
Jedes Icon liegt unverändert unter icons/<app_id>.<Endung>; die Endung entspricht dem gespeicherten Medientyp.
Normen und Spezifikationen
| Gegenstand | Norm oder Spezifikation |
|---|---|
| Archiv | ZIP nach PKWARE APPNOTE |
| Abruf | HTTPS nach RFC 9110 |
| Daten | JSON nach RFC 8259, JSON Lines |
| Zeichenkodierung | UTF-8 nach RFC 3629 |
| Zeitpunkte und Daten | RFC 3339 in UTC |
| Prüfsummen | SHA-256 nach FIPS 180-4 |
| App-Icons | Medientypen nach IANA |
Für diese Dienstart sind keine harmonisierten Normen oder gemeinsamen Spezifikationen nach Art. 35 der Verordnung (EU) 2023/2854 veröffentlicht.