Tagesberichte

Tagesberichte dokumentieren, was auf einer Baustelle oder in einem Projekt an einem einzelnen Kalendertag geschehen ist: wer wie lange vor Ort war, die Witterung, Nachunternehmen, Tätigkeiten, Material- und Geräteeinsatz, Bemerkungen, Fotos und Unterschriften. Ein Bericht wird durch die Kombination aus einem Projekt und einem Datum identifiziert — er ist kein eigenständig gespeichertes Objekt, sondern entsteht aus den einzelnen Einträgen, die für diesen Tag erfasst wurden, entweder vor Ort in der mobilen App verfasst oder automatisch aus der Zeiterfassung befüllt.

Wenn Ihr API-Token auf bestimmte Berechtigungen eingeschränkt ist, benötigt er für jede Operation den passenden Scope: daily_reports:view für alle GET-Anfragen und daily_reports:edit für die Endpunkte für Autofill und Foto-Upload-Token. Das automatische Befüllen eines Berichts, der bereits eingereicht oder freigegeben wurde, erfordert zusätzlich daily_reports:approve; das automatische Befüllen eines archivierten Berichts wird grundsätzlich abgelehnt — er muss zuerst wieder geöffnet werden. Anfragen ohne die erforderliche Berechtigung liefern 403 Forbidden.

Tagesberichte werden in der TimeSec-Web- und -Mobile-App verfasst — und dort wird auch ihr Status geändert (eingereicht, freigegeben, wieder geöffnet). Über die API können Sie Berichte und deren Einträge lesen, das automatische Befüllen aus der Zeiterfassung auslösen, PDFs herunterladen und Foto-Upload-Token anfordern. Das Anlegen von Einträgen und das Ändern des Status eines Berichts stehen für API-Token derzeit nicht zur Verfügung.

Das Bericht-Objekt#

Ein Bericht ist die Gruppe aller Einträge, die dasselbe Projekt und dasselbe Datum teilen. Berichte existieren nur für Projekte, bei denen Tagesberichte in den Projekteinstellungen aktiviert sind, und nur für Tage, die mindestens einen Eintrag haben. Die tag_id ist die id des Projekts, wie sie von der Projekt-API zurückgegeben wird.

Jeder Bericht hat einen berechneten Status, der seine Position im Prüfungsablauf beschreibt:

draft — der Bericht wird gerade bearbeitet und kann vor Ort geändert werden.
submitted — die Baustellenmannschaft hat den Bericht zur Prüfung eingereicht. Nur Vorgesetzte (Benutzer mit der Freigabeberechtigung) dürfen ihn noch ändern.
closed — der Bericht wurde freigegeben. Wie bei submitted ist er für reguläre Bearbeiter gesperrt.
archived — der Bericht wurde von einem Vorgesetzten archiviert. Archivierte Berichte sind unveränderlich (einschließlich des automatischen Befüllens aus der Zeiterfassung), bis ein Vorgesetzter sie zurück auf draft setzt.

Name	Typ	Beschreibung
`id`	string	Synthetischer Bezeichner des Berichts in der Form `<tag_id>\|<date>`, z. B. `3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31\|2024-06-18`. Nur lesbar.
`date`	string (YYYY-MM-DD)	Der Kalendertag, den der Bericht abdeckt.
`tag_id`	string (UUID)	Das Projekt, zu dem der Bericht gehört.
`status`	string	Berechneter Berichtsstatus: `draft`, `submitted`, `closed` oder `archived`.
`tag`	object or null	Das Projekt, zu dem der Bericht gehört, als `{id, name, code, color}`, oder `null`, wenn das Projekt nicht aufgelöst werden konnte. Nur in Listenantworten vorhanden. Nur lesbar.
`address`	string	Die konfigurierte Adresse des Projekts oder eine leere Zeichenkette. Nur in Listenantworten vorhanden. Nur lesbar.
`cost_center`	string	Die konfigurierte Kostenstelle des Projekts oder eine leere Zeichenkette. Nur in Listenantworten vorhanden. Nur lesbar.
`client`	string	Der konfigurierte Auftraggeber des Projekts oder eine leere Zeichenkette. Nur in Listenantworten vorhanden. Nur lesbar.
`contributor_count`	integer	Anzahl der unterschiedlichen Benutzer, die einen Eintrag zu diesem Bericht verfasst haben. Nur in Listenantworten vorhanden. Nur lesbar.
`employees`	array of objects	Mitarbeiter mit `employee-working-times`-Einträgen in diesem Bericht, als `{id, first_name, last_name}`. Nur in Listenantworten vorhanden. Nur lesbar.
`total_hours`	number	Summe der `hours`-Werte über die `employee-working-times`-Einträge des Berichts. Nur in Listenantworten vorhanden. Nur lesbar.
`weather`	array of objects	Die erfassten Wetterwerte des Berichts, sortiert nach `time`. Jedes Objekt hat dieselbe Struktur wie die Wertfelder des `weather`-Eintrags. Nur in Listenantworten vorhanden. Nur lesbar.
`values`	array of objects	Der jeweils neueste sichtbare Wert des Berichts je Feldtyp (nicht je Gruppe), jeweils mit den typspezifischen Wertfeldern dieses Feldes sowie einem Schlüssel `type`. Damit kann ein Übersichts-Client eine Berichtskarte darstellen, ohne den Endpunkt für Einträge zusätzlich abzufragen. Nur in Listenantworten vorhanden. Nur lesbar.

Feldkonfigurationen#

Welche Felder ein Tagesbericht enthält, ist je Organisation konfigurierbar, und die Konfiguration ist nach Datum versioniert. Ihre Organisation führt eine Liste von Konfigurationen, jede mit einem Datum valid_from; die für einen Bericht geltende Konfiguration ist diejenige mit dem jüngsten valid_from am oder vor dem Datum des Berichts (eine Konfiguration wird an ihrem valid_from-Tag aktiv).

Ein Bericht, dessen Datum vor allen gespeicherten valid_from-Daten liegt, verwendet die älteste Konfiguration Ihrer Organisation. Die erste Version wird geschrieben, wenn Tagesberichte aktiviert werden; Berichte für Tage vor dieser Aktivierung passen daher zu gar keiner Version — sie werden mit dem ältesten Feldsatz dargestellt, den Ihre Organisation je hatte, nicht mit dem eingebauten Standardformular. Das unten stehende Standardformular gilt nur für Organisationen, die überhaupt keine Konfiguration haben:

Feld-ID	Typ	Bezeichnung (Deutsch)
`weather`	`weather`	Witterung
`employee-working-times`	`employee-working-times`	Mitarbeitende
`subcontractors`	`subcontractors`	Nachunternehmen
`activities`	`activities`	Tätigkeiten
`materials`	`string`	Material- / Geräteeinsatz
`comments`	`string`	Bemerkungen / Behinderungen
`photos`	`image`	Fotos
`signatures`	`signature`	Unterschriften

Die Versionierung hat zwei Konsequenzen, die Ihnen in der API auffallen werden:

Jeder Eintrag wird gegen die Konfiguration interpretiert und validiert, die am Datum des Eintrags aktiv ist, nicht gegen die heute aktive. Historische Berichte behalten das Formular, mit dem sie geschrieben wurden, auch nachdem die Organisation ihr Berichtslayout ändert.
Einträge, deren Feld-ID in der für ihr Datum aktiven Konfiguration nicht existiert (zum Beispiel ein später entferntes Feld), werden in Eintragslisten und PDFs weggelassen — sie haben kein Schema, mit dem sie dargestellt werden könnten.

Verwenden Sie den Endpunkt für Feldtypen, um die verfügbaren Feldtypen zu ermitteln und zu erfahren, wie Einträge des jeweiligen Typs gruppiert werden.

Das Eintrag-Objekt#

Einträge sind ausschließlich anfügend: Nichts wird jemals an Ort und Stelle aktualisiert. Jeder Eintrag gehört zu einer logischen Gruppe, die durch ihre group_id identifiziert wird; diese kombiniert date und tag_id des Berichts mit typspezifischen Schlüsseln (zum Beispiel eine Gruppe je Mitarbeiter für Arbeitszeiten oder eine Gruppe je Autor und Text für Bemerkungen). Der jüngste Eintrag einer Gruppe ist ihr aktueller Wert; ältere Einträge bilden die Historie der Gruppe. Ein Eintrag mit burned: true ist ein Grabstein, der seine Gruppe als gelöscht markiert.

Einträge, die vom System geschrieben werden — das automatische Befüllen aus der Zeiterfassung und die automatische Wettererfassung —, haben author_id: null; der betroffene Mitarbeiter wird in on_behalf_of_id geführt. Manuell verfasste Einträge tragen den Autor, und on_behalf_of_id benennt die Person, um die es im Eintrag geht (z. B. wer unterschrieben hat oder wessen Arbeitszeit korrigiert wurde).

Name	Typ	Beschreibung
`id`	string (UUID)	Eindeutiger Bezeichner des Eintrags. Nur lesbar.
`group_id`	string	Durch Pipe getrennter Gruppierungsschlüssel, beginnend mit `date` und `tag_id`, gefolgt von den Gruppierungswerten des Feldtyps. Nur lesbar.
`group_count`	integer	Anzahl der Einträge in der Gruppe dieses Eintrags, die den Filtern der Anfrage entsprechen, einschließlich Grabsteinen — eine Filterung über `ids` schließt die übrigen Einträge der Gruppe aus der Zählung aus. Nur in Listenantworten vorhanden. Nur lesbar.
`field_id`	string	ID des Berichtsfelds, zu dem der Eintrag gehört, wie in der aktiven Feldkonfiguration definiert (z. B. `comments`).
`type`	string	Der Typ des Felds: `weather`, `employee-working-times`, `subcontractors`, `activities`, `string`, `image` oder `signature`.
`date`	string (YYYY-MM-DD)	Der Berichtstag, zu dem der Eintrag gehört.
`tag_id`	string (UUID)	Das Projekt, zu dem der Eintrag gehört.
`author_id`	string (UUID) or null	Der Benutzer, der den Eintrag verfasst hat, oder `null` bei systemgenerierten Einträgen (Autofill, Wettererfassung).
`author_name`	string or null	Vollständiger Name des Autors, oder `null`.
`on_behalf_of_id`	string (UUID) or null	Der Benutzer, um den es im Eintrag geht (z. B. der Mitarbeiter, dessen Stunden erfasst werden, oder die Person, die unterschrieben hat), oder `null`.
`on_behalf_of_name`	string or null	Vollständiger Name des `on_behalf_of`-Benutzers, oder `null`.
`burned`	boolean	`true` markiert den Eintrag als Grabstein: Die Gruppe, zu der er gehört, ist als gelöscht zu behandeln, wenn der Grabstein der jüngste Eintrag der Gruppe ist.
`submitted_at`	string (ISO 8601, local time) or null	Zeitpunkt, zu dem der Eintrag den Server erreicht hat, z. B. `2024-06-18T16:42:07`. `null` bei systemgenerierten Einträgen.
`created_at`	string (ISO 8601, local time)	Zeitpunkt, zu dem der Eintrag gespeichert wurde. Nur lesbar.
`modified_at`	string (ISO 8601, local time)	Zeitpunkt der letzten Änderung des Eintrags. Nur lesbar.

Typspezifische Wertfelder#

Zusätzlich zu den oben genannten gemeinsamen Eigenschaften trägt jeder Eintrag die Wertfelder seines Typs:

weather — time (string, eine Uhrzeit wie 08:00), temperature (number oder null) und weather_condition: einer der Werte sunny, cloudy, precipitation oder snow, oder null, wenn der Messwert keine verwertbare Wetterlage enthält. Die vier Kategorien sind diejenigen, die in der Antwort der Feldtypen unter choices.condition aufgeführt sind. Gruppiert nach time, sodass ein Bericht eine Wetterzeile je konfiguriertem Zeitpunkt enthält.

Schreibvorgänge dürfen zusätzlich precipitation und cloud_cover (numbers) sowie wind (ein Paar [speed, direction] mit der Richtung in Grad 0–359) übertragen. Diese Schlüssel werden weiterhin validiert und gespeichert, beim Lesen jedoch nicht mehr zurückgegeben. Automatisch erfasste Messwerte werden auf dieselbe Weise reduziert: Die detaillierte Antwort des Wetteranbieters bleibt serverseitig und wird auf die eine Kategorie weather_condition zusammengefasst.
employee-working-times — hours (number zwischen 0 und 24) sowie eine Momentaufnahme des Mitarbeiters zum Zeitpunkt, zu dem der Eintrag geschrieben wurde: employee_account_id (string), employee_name (string) und employee_position (string, aus dem benutzerdefinierten Feld position des Mitarbeiters; leere Zeichenkette, wenn nicht gesetzt). Die Momentaufnahme hält den Bericht korrekt, selbst wenn sich das Benutzerkonto oder die benutzerdefinierten Felder des Mitarbeiters später ändern. Gruppiert nach on_behalf_of_id: eine Zeile je Mitarbeiter und Tag.
subcontractors — name (string), employees (integer), hours (number oder null), comment (string oder null). Gruppiert nach on_behalf_of_id und name.
activities — text (string). Gruppiert nach on_behalf_of_id und text, sodass derselbe Tätigkeitstext für dieselbe Person dedupliziert wird.
string — value (string). Wird von den Standardfeldern materials und comments verwendet. Gruppiert nach on_behalf_of_id und value.
image — image_id (string), image_key (string oder null, der S3-Objektschlüssel aus dem Foto-Upload-Ablauf), image_url (string oder null — eine aus image_key abgeleitete, vorsignierte Download-URL, eine Stunde lang gültig), thumb_key (string oder null, der Objektschlüssel der verkleinerten Vorschau), thumb_url (string oder null — eine aus thumb_key abgeleitete, vorsignierte Download-URL, eine Stunde lang gültig), latitude / longitude (numbers oder null) und taken_at (string oder null). Gruppiert nach on_behalf_of_id und image_id. thumb_key und thumb_url sind null bei Einträgen, deren Client keine Vorschau hochgeladen hat; greifen Sie in diesem Fall auf image_url zurück.
signature — image (string, eine Daten-URL der Unterschrift im Format data:image/...). Gruppiert nach on_behalf_of_id: eine Unterschrift je Person und Bericht.

Alle Berichte auflisten#

GET/api/v2/daily-reports/reports/

Rufen Sie paginierte Berichtsbeschreibungen für Projekte und Daten ab, die Einträge enthalten. Die Ergebnisse sind absteigend nach Datum sortiert, danach nach Projekt-ID.

Query-Parameter#

Name	Typ	Beschreibung
`date_from`	string (YYYY-MM-DD)	Bezieht Berichte an oder nach diesem Datum ein
`date_to`	string (YYYY-MM-DD)	Bezieht Berichte an oder vor diesem Datum ein
`daterange`	string	Inklusives Bereichsformat `YYYY-MM-DD\|YYYY-MM-DD`
`projects`	string	Durch Pipe getrennte Projekt-UUIDs zum Filtern
`status`	string	Durch Pipe getrennte Status: `draft`, `submitted`, `closed`, `archived`
`limit`	integer	Ergebnisse je Seite (Standard 100, Maximum 1000)
`offset`	integer	Zu überspringende Ergebnisse (Standard 0)

Anfrage#

cURL

curl -X GET "https://api.timesec.de/api/v2/daily-reports/reports/?date_from=2024-06-17&date_to=2024-06-18&status=draft|submitted" \
  -H "Authorization: Token <YOUR_API_TOKEN>"

Antwort#

JSON

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31|2024-06-18",
      "date": "2024-06-18",
      "tag_id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
      "status": "submitted",
      "tag": {
        "id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
        "name": "Neubau Lagerhalle",
        "code": "P-2024-018",
        "color": "#2563eb"
      },
      "address": "Industriestraße 12, 44269 Dortmund",
      "cost_center": "4711",
      "client": "Musterbau GmbH",
      "contributor_count": 2,
      "employees": [
        {
          "id": "508d5250-7399-4b65-a574-3da53d9ddc25",
          "first_name": "Anna",
          "last_name": "Schmidt"
        }
      ],
      "total_hours": 7.75,
      "weather": [
        {
          "time": "08:00",
          "temperature": 14.2,
          "weather_condition": "cloudy"
        }
      ],
      "values": [
        {
          "type": "weather",
          "time": "08:00",
          "temperature": 14.2,
          "weather_condition": "cloudy"
        },
        {
          "type": "employee-working-times",
          "on_behalf_of_id": "508d5250-7399-4b65-a574-3da53d9ddc25",
          "on_behalf_of_name": "Anna Schmidt",
          "hours": 7.75
        }
      ]
    },
    {
      "id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31|2024-06-17",
      "date": "2024-06-17",
      "tag_id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
      "status": "draft",
      "tag": {
        "id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
        "name": "Neubau Lagerhalle",
        "code": "P-2024-018",
        "color": "#2563eb"
      },
      "address": "Industriestraße 12, 44269 Dortmund",
      "cost_center": "4711",
      "client": "Musterbau GmbH",
      "contributor_count": 0,
      "employees": [],
      "total_hours": 0,
      "weather": [],
      "values": []
    }
  ]
}

Feldtypen auflisten#

GET/api/v2/daily-reports/reports/field-types/

Rufen Sie die verfügbaren Feldtypen, ihre Gruppierungsschlüssel und menschenlesbare Beschreibungen ab. Jeder Typ enthält Auswahllisten für Felder mit festen Werten.

Anfrage#

cURL

curl -X GET "https://api.timesec.de/api/v2/daily-reports/reports/field-types/" \
  -H "Authorization: Token <YOUR_API_TOKEN>"

Antwort#

JSON

{
  "count": 7,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "weather",
      "group_by": [
        "date",
        "tag_id",
        "time"
      ],
      "description": "Weather readings for configured local report times.\n\nConfig: requires `times`, a list of HHMM strings such as `[\"0800\"]`, and\n`autofill_from_api`, a boolean that controls weather autofill from an API.",
      "choices": {
        "condition": [
          {
            "id": "sunny",
            "label": "Sonnig"
          },
          {
            "id": "cloudy",
            "label": "Bewölkt"
          },
          {
            "id": "precipitation",
            "label": "Niederschlag"
          },
          {
            "id": "snow",
            "label": "Schnee"
          }
        ]
      }
    },
    {
      "id": "employee-working-times",
      "group_by": [
        "date",
        "tag_id",
        "on_behalf_of_id"
      ],
      "description": "Working-time totals for employees contributing to a daily report.\n\nConfig: requires `autofill_from_tracking`, a boolean that controls whether\ntracked working times are imported automatically.",
      "choices": {}
    },
    {
      "id": "subcontractors",
      "group_by": [
        "date",
        "tag_id",
        "on_behalf_of_id",
        "name"
      ],
      "description": "Per-day list of subcontractor companies present on a project.\n\nConfig: no options are supported; pass `{}` or omit the config.\nValues require `name` and `employees`; `hours` and `comment` are optional.",
      "choices": {}
    },
    {
      "id": "activities",
      "group_by": [
        "date",
        "tag_id",
        "on_behalf_of_id",
        "text"
      ],
      "description": "Activity notes for work performed on a daily report.\n\nConfig: requires `autofill_from_tracking`, a boolean that controls whether\ntime-tracking comments are imported automatically.",
      "choices": {}
    },
    {
      "id": "string",
      "group_by": [
        "date",
        "tag_id",
        "on_behalf_of_id",
        "value"
      ],
      "description": "Free-text report entry used for configurable text fields.\n\nConfig: no options are supported; pass `{}` or omit the config.",
      "choices": {}
    },
    {
      "id": "image",
      "group_by": [
        "date",
        "tag_id",
        "on_behalf_of_id",
        "image_id"
      ],
      "description": "Photo attachment for a daily report, including optional capture metadata.\n\nConfig: no options are supported; pass `{}` or omit the config.",
      "choices": {}
    },
    {
      "id": "signature",
      "group_by": [
        "date",
        "tag_id",
        "on_behalf_of_id"
      ],
      "description": "Signature image captured for a report participant.\n\nConfig: no options are supported; pass `{}` or omit the config.",
      "choices": {}
    }
  ]
}

Berichtsstatus abrufen#

GET/api/v2/daily-reports/reports/status/

Rufen Sie den aktuellen Status eines einzelnen Berichts ab. Ein Bericht ohne Statusübergänge hat standardmäßig den Status draft.

Query-Parameter#

Name	Typ	Beschreibung
`tag`	string (UUID)	Projekt-ID (erforderlich)
`date`	string (YYYY-MM-DD)	Berichtsdatum (erforderlich)

Anfrage#

cURL

curl -X GET "https://api.timesec.de/api/v2/daily-reports/reports/status/?tag=3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31&date=2024-06-18" \
  -H "Authorization: Token <YOUR_API_TOKEN>"

Antwort#

JSON

{
  "tag_id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
  "date": "2024-06-18",
  "status": "submitted"
}

Einen Bericht automatisch befüllen#

POST/api/v2/daily-reports/reports/autofill/

Berechnet Einträge aus der täglichen Zeiterfassung und speichert sie. Nur Felder, die mit autofill_from_tracking konfiguriert sind, werden befüllt: Arbeitszeiten der Mitarbeiter und Tätigkeiten. Die Operation ist idempotent; manuell korrigierte Werte bleiben erhalten.

Body-Parameter#

Name	Typ	Beschreibung
`tag`	string (UUID)	Projekt-ID (erforderlich)
`date`	string (YYYY-MM-DD)	Berichtsdatum (erforderlich)
`field`	string	Optionale Feld-ID, um das automatische Befüllen einzuschränken

Anfrage#

cURL

curl -X POST "https://api.timesec.de/api/v2/daily-reports/reports/autofill/" \
  -H "Authorization: Token <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "tag": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
    "date": "2024-06-18"
  }'

Antwort#

JSON

{
  "tag_id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
  "date": "2024-06-18",
  "filled": [
    "employee-working-times",
    "activities"
  ]
}

Ein Bericht-PDF herunterladen#

GET/api/v2/daily-reports/reports/:id/pdf/

Stellt einen Bericht als druckfreundliches PDF dar. Das Format der ID ist <tag_id>|<date>, wobei | wörtlich oder prozentkodiert als %7C gesendet wird. Die Antwort streamt PDF-Binärdaten mit dem Dateinamen Tagesbericht-<project code>-<date>.pdf.

Anfrage#

cURL

curl -X GET "https://api.timesec.de/api/v2/daily-reports/reports/3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31%7C2024-06-18/pdf/" \
  -H "Authorization: Token <YOUR_API_TOKEN>" \
  -o "Tagesbericht-2024-06-18.pdf"

Alle Einträge auflisten#

GET/api/v2/daily-reports/entries/

Rufen Sie paginierte Berichtseinträge ab, gefiltert über die aktiven Feldkonfigurationen. Verwenden Sie grouped=1, um nur den jüngsten Eintrag je Gruppe anzuzeigen.

Query-Parameter#

Name	Typ	Beschreibung
`tags`	string	Durch Pipe getrennte Projekt-UUIDs
`field_id`	string	Filtert auf ein konfiguriertes Feld
`daterange`	string	Inklusiver Bereich `YYYY-MM-DD\|YYYY-MM-DD`
`grouped`	string	Auf `1` setzen für den jüngsten Eintrag je Gruppe
`ids`	string	Durch Pipe getrennte Eintrags-UUIDs
`limit`	integer	Ergebnisse je Seite (Standard 100, Maximum 1000)
`offset`	integer	Zu überspringende Ergebnisse (Standard 0)

Anfrage#

cURL

curl -X GET "https://api.timesec.de/api/v2/daily-reports/entries/?tags=3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31&daterange=2024-06-18|2024-06-18&grouped=1" \
  -H "Authorization: Token <YOUR_API_TOKEN>"

Antwort#

JSON

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "group_id": "2024-06-18|3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31|508d5250-7399-4b65-a574-3da53d9ddc25",
      "id": "6b0f2d84-3c9e-4f17-8a52-b1d4e7c90a63",
      "field_id": "employee-working-times",
      "type": "employee-working-times",
      "created_at": "2024-06-18T17:02:11",
      "modified_at": "2024-06-18T17:02:11",
      "submitted_at": null,
      "date": "2024-06-18",
      "tag_id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
      "author_id": null,
      "on_behalf_of_id": "508d5250-7399-4b65-a574-3da53d9ddc25",
      "author_name": null,
      "on_behalf_of_name": "Anna Schmidt",
      "burned": false,
      "hours": 7.75,
      "group_count": 1
    },
    {
      "group_id": "2024-06-18|3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31|e7c9a4d2-1f38-4b6a-9c05-8d2f7b3e6a14|Lieferung Schalholz verspätet",
      "id": "9d47c1f0-5e2b-4a86-b3f9-0c61d8a24e57",
      "field_id": "comments",
      "type": "string",
      "created_at": "2024-06-18T16:42:09",
      "modified_at": "2024-06-18T16:42:09",
      "submitted_at": "2024-06-18T16:42:07",
      "date": "2024-06-18",
      "tag_id": "3f2b8c1e-9a47-4d05-b8a1-6c2d94e07f31",
      "author_id": "e7c9a4d2-1f38-4b6a-9c05-8d2f7b3e6a14",
      "on_behalf_of_id": "e7c9a4d2-1f38-4b6a-9c05-8d2f7b3e6a14",
      "author_name": "Jonas Weber",
      "on_behalf_of_name": "Jonas Weber",
      "burned": false,
      "value": "Lieferung Schalholz verspätet",
      "group_count": 1
    }
  ]
}

Ein Foto-Upload-Token abrufen#

POST/api/v2/daily-reports/entries/upload-photo-token/

Erzeugt vorsignierte S3-Upload-Anmeldedaten für Fotos in Tagesberichten (maximal 2 MB). Die Antwort enthält Formularfelder für den Upload sowohl der Vollbild- als auch der Vorschauversion und ist 12 Stunden gültig.

Body-Parameter#

Name	Typ	Beschreibung
`filename`	string	Dateiname für den Speicherschlüssel
`filetype`	string	MIME-Typ (z. B. `image/jpeg`)
`filesize`	integer	Dateigröße in Bytes (maximal 2097152)

Anfrage#

cURL

curl -X POST "https://api.timesec.de/api/v2/daily-reports/entries/upload-photo-token/" \
  -H "Authorization: Token <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "betonage-nord",
    "filetype": "image/jpeg",
    "filesize": 2048576
  }'

Antwort#

JSON

{
  "url": "https://s3.eu-central-1.amazonaws.com/timesec-uploads",
  "fields": {
    "key": "i-f4a5b6c7-d8e9-0123-fabc-456789012345/u-a1b2c3d4-e5f6-7890-abcd-ef1234567890/daily-reports/2024/06/18/0d3e2b1a-4c5d-6e7f-8901-234567890abc/2024-06-18_4f2a_betonage-nord.jpg",
    "AWSAccessKeyId": "AKIAIOSFODNN7EXAMPLE",
    "policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMDYtMTlUMDY6MzA6MDBaIiwgImNvbmRpdGlvbnMiOiBbXX0=",
    "signature": "hV0kwGx0ZQKgQnJ1zW0m9dEXAMPLE"
  },
  "thumb_fields": {
    "key": "i-f4a5b6c7-d8e9-0123-fabc-456789012345/u-a1b2c3d4-e5f6-7890-abcd-ef1234567890/daily-reports/2024/06/18/0d3e2b1a-4c5d-6e7f-8901-234567890abc/2024-06-18_4f2a_betonage-nord.thumb.jpg",
    "AWSAccessKeyId": "AKIAIOSFODNN7EXAMPLE",
    "policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMDYtMTlUMDY6MzA6MDBaIiwgImNvbmRpdGlvbnMiOiBbXX0=",
    "signature": "yQ2mNpR7bTfLc0aVzX4jE9EXAMPLE"
  }
}