Zum Inhalt springen
Developer

EventTimingRead

Veranstaltungen6 EndpunkteEvent / EventTimingRead

Liefert eine Liste der Einträge zu Veranstaltungs-Zeitablesungen.

GET/api/event/timing_read

Query-Parameter

idinteger
baseEventstring
timingPointstring
signUpstring
devicestring
rawBibstring
rawChipstring
readTimestring
readTimeMsstringUnix-Zeit in Millisekunden (Gerätezeit, korrigiert um ihren Versatz). | Benötigt Zugriffsrecht: SCOPE
sourcestring
externalIdstringID des Messwerts an seiner Quelle (Gerätesequenznummer, CSV-Zeile), für die Idempotenz verwendet. | Benötigt Zugriffsrecht: SCOPE
statusstring
createdstring
searchStringstringText, nach dem in der Liste gesucht wird
orderFieldNamestringName des Bestellfelds
orderFieldSortstringSortiermodusErlaubt: DESCASC
pageintegerSeite der Liste
pageSizeintegerAnzahl der Einträge je Seite
withMaxPageNumberstringgibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert eine Liste der EventTimingRead-Objekte.array<EventTimingRead>

Felder anzeigen (19)
  • base_event_idinteger
  • timing_point_idinteger
  • sign_up_idinteger
  • bib_labelstring
  • namestring
  • device_idinteger
  • read_time_msinteger

    Unix-Zeit in Millisekunden (Gerätezeit, korrigiert um ihren Versatz).

  • idinteger

    Primärschlüssel der Zeitnahme-Erfassung. Interne ID.

  • raw_bibstring

    Startnummer, wie vom Gerät gelesen.

  • raw_chipstring

    Chip-ID, wie sie vom Gerät gelesen wird.

  • read_timestring (date-time)

    Zeitpunkt des Lesevorgangs.

  • sourcestring

    Quelle der Ablesung, zum Beispiel Gerät oder manuelle Eingabe.

  • external_idstring

    ID des Messwerts an seiner Quelle (Gerätesequenznummer, CSV-Zeile), für die Idempotenz verwendet.

  • statusstring

    Status der Ablesung, zum Beispiel zugeordnet oder unbekannt.

  • latitudenumber (float)

    Breitengrad der Ablesung in Grad, falls bekannt.

  • longitudenumber (float)

    Längengrad der Ablesung in Grad, falls bekannt.

  • accuracynumber (float)

    Genauigkeit der Position in Metern.

  • notestring

    Anmerkung zum Lesen.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Lesevorgang gespeichert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/timing_read \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "name": "Beispiel",
    "id": 42,
    "base_event_id": 42,
    "timing_point_id": 42,
    "sign_up_id": 42,
    "bib_label": "string",
    "device_id": 42,
    "read_time_ms": 1,
    "raw_bib": "string",
    "raw_chip": "string"
  }
]

Manuelle Ablesung, z. B. am Ziel eingegeben. Ohne read_time_ms wird die Serverzeit verwendet.

POST/api/event/timing_read

Request-Body application/json

  • base_eventinteger
  • timing_pointinteger
  • bibstring
  • sign_upinteger
  • read_time_msinteger

Antworten

200{results: [ReadResult]}

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/timing_read \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "base_event": 1,
  "timing_point": 1,
  "bib": "string",
  "sign_up": 1,
  "read_time_ms": 1
}
'

Mehrere Messwerte auf einmal, zum Beispiel von einer App oder einem externen Zeitmesssystem.

POST/api/event/timing_read/batch

Request-Body application/json

  • base_eventinteger
  • readsarray<object>

Antworten

200{results: [ReadResult]}

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/timing_read/batch \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "base_event": 1,
  "reads": [
    {}
  ]
}
'

Korrektur einer Lesung: Status (z. B. IGNORED), zugeordnete Anmeldung oder Zeitpunkt.

PUT/api/event/timing_read/{identifier}

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • statusstring
  • sign_upinteger
  • timing_pointinteger

Antworten

200Der aktualisierte LesestatusEventTimingRead

Felder anzeigen (19)
  • base_event_idinteger
  • timing_point_idinteger
  • sign_up_idinteger
  • bib_labelstring
  • namestring
  • device_idinteger
  • read_time_msinteger

    Unix-Zeit in Millisekunden (Gerätezeit, korrigiert um ihren Versatz).

  • idinteger

    Primärschlüssel der Zeitnahme-Erfassung. Interne ID.

  • raw_bibstring

    Startnummer, wie vom Gerät gelesen.

  • raw_chipstring

    Chip-ID, wie sie vom Gerät gelesen wird.

  • read_timestring (date-time)

    Zeitpunkt des Lesevorgangs.

  • sourcestring

    Quelle der Ablesung, zum Beispiel Gerät oder manuelle Eingabe.

  • external_idstring

    ID des Messwerts an seiner Quelle (Gerätesequenznummer, CSV-Zeile), für die Idempotenz verwendet.

  • statusstring

    Status der Ablesung, zum Beispiel zugeordnet oder unbekannt.

  • latitudenumber (float)

    Breitengrad der Ablesung in Grad, falls bekannt.

  • longitudenumber (float)

    Längengrad der Ablesung in Grad, falls bekannt.

  • accuracynumber (float)

    Genauigkeit der Position in Metern.

  • notestring

    Anmerkung zum Lesen.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Lesevorgang gespeichert wurde.

Anfrage
curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/event/timing_read/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "status": "string",
  "sign_up": 1,
  "timing_point": 1
}
'
Antwort 200 application/json
{
  "name": "Beispiel",
  "id": 42,
  "base_event_id": 42,
  "timing_point_id": 42,
  "sign_up_id": 42,
  "bib_label": "string",
  "device_id": 42,
  "read_time_ms": 1,
  "raw_bib": "string",
  "raw_chip": "string"
}

Korrektur einer Lesung: Status (z. B. IGNORED), zugeordnete Anmeldung oder Zeitpunkt.

PATCH/api/event/timing_read/{identifier}

Pfad-Parameter

identifierPflichtstring

Request-Body application/json

  • statusstring
  • sign_upinteger
  • timing_pointinteger

Antworten

200Der aktualisierte LesestatusEventTimingRead

Felder anzeigen (19)
  • base_event_idinteger
  • timing_point_idinteger
  • sign_up_idinteger
  • bib_labelstring
  • namestring
  • device_idinteger
  • read_time_msinteger

    Unix-Zeit in Millisekunden (Gerätezeit, korrigiert um ihren Versatz).

  • idinteger

    Primärschlüssel der Zeitnahme-Erfassung. Interne ID.

  • raw_bibstring

    Startnummer, wie vom Gerät gelesen.

  • raw_chipstring

    Chip-ID, wie sie vom Gerät gelesen wird.

  • read_timestring (date-time)

    Zeitpunkt des Lesevorgangs.

  • sourcestring

    Quelle der Ablesung, zum Beispiel Gerät oder manuelle Eingabe.

  • external_idstring

    ID des Messwerts an seiner Quelle (Gerätesequenznummer, CSV-Zeile), für die Idempotenz verwendet.

  • statusstring

    Status der Ablesung, zum Beispiel zugeordnet oder unbekannt.

  • latitudenumber (float)

    Breitengrad der Ablesung in Grad, falls bekannt.

  • longitudenumber (float)

    Längengrad der Ablesung in Grad, falls bekannt.

  • accuracynumber (float)

    Genauigkeit der Position in Metern.

  • notestring

    Anmerkung zum Lesen.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Lesevorgang gespeichert wurde.

Anfrage
curl --request PATCH \
  --url https://eure-instanz.iw-erp.de/api/event/timing_read/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "status": "string",
  "sign_up": 1,
  "timing_point": 1
}
'
Antwort 200 application/json
{
  "name": "Beispiel",
  "id": 42,
  "base_event_id": 42,
  "timing_point_id": 42,
  "sign_up_id": 42,
  "bib_label": "string",
  "device_id": 42,
  "read_time_ms": 1,
  "raw_bib": "string",
  "raw_chip": "string"
}

CSV-Import (Multipart-Feld "file"), siehe docs/event/STARTNUMMERN_ZEITMESSUNG.md.

POST/api/event/base_event/{identifier}/timing/import_csv

Pfad-Parameter

identifierPflichtstring

Request-Body multipart/form-data

  • filestring (binary)

Antworten

200{results, created, duplicates, unassigned, errors}

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/base_event/42/timing/import_csv \
  --header 'content-type: multipart/form-data' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --form file='@datei.pdf'