Zum Inhalt springen
Developer

Media Files

Medien / Mediendateien

Medien6 EndpunkteMedia / Media Files

Diese Methode liefert alle MediaFileInfo-Objekte

GET/api/media/media/file

Query-Parameter

namestringinterner Name | Erforderliches Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicTitlestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicSubtitlestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicKeywordsstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicDatestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicOrderstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicSeasonstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicFileMimestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
addonData_customFilterstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
archivedboolean
generatedId3boolean
idinteger
createdstring
updatedstring
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 MediaFileInfo-Objekte.array<MediaFileInfo>

Felder anzeigen (31)
  • idinteger

    Primärschlüssel der Mediendatei. Interne ID.

  • media_file_typestring

    Art der Mediendatei, zum Beispiel Audio, Video oder Bild.

  • archivedboolean

    Die Datei ist archiviert.

  • namestring

    interner Name

  • descriptionstring

    interne Beschreibung

  • public_titlestring

    Titel, der öffentlich angezeigt wird.

  • public_subtitlestring

    Untertitel, der öffentlich angezeigt wird.

  • public_linkstring

    Öffentlicher Link zur Datei.

  • public_authorstring

    Öffentlich angezeigter Autor.

  • public_summarystring

    Kurze Zusammenfassung, die öffentlich angezeigt wird.

  • public_descriptionstring

    Beschreibung, die öffentlich angezeigt wird.

  • public_explicitboolean

    Der Inhalt ist als explizit gekennzeichnet.

  • public_thumbnailstring

    URL der Vorschau.

  • public_keywordsstring

    Schlüsselwörter der Datei.

  • public_file_urlstring

    URL der Datei.

  • public_file_namestring

    Name der Datei.

  • public_file_mimestring

    MIME-Typ der Datei.

  • public_file_sizeinteger

    Größe der Datei in Bytes.

  • public_durationinteger

    Dauer von Audio oder Video in Sekunden.

  • public_dimension_xinteger

    Breite des Bildes oder Videos in Pixel.

  • public_dimension_yinteger

    Höhe des Bildes oder Videos in Pixeln.

  • public_datestring (date-time)

    Veröffentlichungsdatum der Datei.

  • public_orderinteger

    Reihenfolge der Datei innerhalb ihrer Gruppe.

  • public_episode_typestring

    Episodentyp für Podcasts, zum Beispiel full oder trailer.

  • public_seasonstring

    Staffel für Podcasts.

  • generated_id3boolean

    ID3-Tags wurden aus der Datei erzeugt.

  • guidstring

    Global eindeutige ID der Datei, in Feeds verwendet.

  • display_start_hourinteger

    Stunde, ab der die Datei angezeigt wird.

  • display_end_hourinteger

    Stunde, bis zu der die Datei angezeigt wird.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/media/media/file \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "id": 42,
    "name": "Beispiel",
    "description": "Text",
    "public_title": "Beispiel",
    "public_description": "Text",
    "public_file_url": "https://vynst.de",
    "public_file_name": "Beispiel",
    "media_file_type": "string",
    "archived": true,
    "public_subtitle": "string"
  }
]

MediaFileInfo neu anlegen

POST/api/media/media/{groupIdentifier}/file

Pfad-Parameter

groupIdentifierPflichtstring

Request-Body application/json

  • dataMediaFileInfo2

Antworten

200MediaFileInfo neu anlegenMediaFileInfo

Felder anzeigen (31)
  • idinteger

    Primärschlüssel der Mediendatei. Interne ID.

  • media_file_typestring

    Art der Mediendatei, zum Beispiel Audio, Video oder Bild.

  • archivedboolean

    Die Datei ist archiviert.

  • namestring

    interner Name

  • descriptionstring

    interne Beschreibung

  • public_titlestring

    Titel, der öffentlich angezeigt wird.

  • public_subtitlestring

    Untertitel, der öffentlich angezeigt wird.

  • public_linkstring

    Öffentlicher Link zur Datei.

  • public_authorstring

    Öffentlich angezeigter Autor.

  • public_summarystring

    Kurze Zusammenfassung, die öffentlich angezeigt wird.

  • public_descriptionstring

    Beschreibung, die öffentlich angezeigt wird.

  • public_explicitboolean

    Der Inhalt ist als explizit gekennzeichnet.

  • public_thumbnailstring

    URL der Vorschau.

  • public_keywordsstring

    Schlüsselwörter der Datei.

  • public_file_urlstring

    URL der Datei.

  • public_file_namestring

    Name der Datei.

  • public_file_mimestring

    MIME-Typ der Datei.

  • public_file_sizeinteger

    Größe der Datei in Bytes.

  • public_durationinteger

    Dauer von Audio oder Video in Sekunden.

  • public_dimension_xinteger

    Breite des Bildes oder Videos in Pixel.

  • public_dimension_yinteger

    Höhe des Bildes oder Videos in Pixeln.

  • public_datestring (date-time)

    Veröffentlichungsdatum der Datei.

  • public_orderinteger

    Reihenfolge der Datei innerhalb ihrer Gruppe.

  • public_episode_typestring

    Episodentyp für Podcasts, zum Beispiel full oder trailer.

  • public_seasonstring

    Staffel für Podcasts.

  • generated_id3boolean

    ID3-Tags wurden aus der Datei erzeugt.

  • guidstring

    Global eindeutige ID der Datei, in Feeds verwendet.

  • display_start_hourinteger

    Stunde, ab der die Datei angezeigt wird.

  • display_end_hourinteger

    Stunde, bis zu der die Datei angezeigt wird.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/media/media/42/file \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '{}'
Antwort 200 application/json
{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "public_title": "Beispiel",
  "public_description": "Text",
  "public_file_url": "https://vynst.de",
  "public_file_name": "Beispiel",
  "media_file_type": "string",
  "archived": true,
  "public_subtitle": "string"
}

Diese Methode liefert eine einzelne MediaFileInfo mit der angegebenen ID

GET/api/media/media/{fileIdentifier}/file

Pfad-Parameter

fileIdentifierPflichtstring

Antworten

200Liefert ein einzelnes MediaFileInfo-Objekt.MediaFileInfo

Felder anzeigen (31)
  • idinteger

    Primärschlüssel der Mediendatei. Interne ID.

  • media_file_typestring

    Art der Mediendatei, zum Beispiel Audio, Video oder Bild.

  • archivedboolean

    Die Datei ist archiviert.

  • namestring

    interner Name

  • descriptionstring

    interne Beschreibung

  • public_titlestring

    Titel, der öffentlich angezeigt wird.

  • public_subtitlestring

    Untertitel, der öffentlich angezeigt wird.

  • public_linkstring

    Öffentlicher Link zur Datei.

  • public_authorstring

    Öffentlich angezeigter Autor.

  • public_summarystring

    Kurze Zusammenfassung, die öffentlich angezeigt wird.

  • public_descriptionstring

    Beschreibung, die öffentlich angezeigt wird.

  • public_explicitboolean

    Der Inhalt ist als explizit gekennzeichnet.

  • public_thumbnailstring

    URL der Vorschau.

  • public_keywordsstring

    Schlüsselwörter der Datei.

  • public_file_urlstring

    URL der Datei.

  • public_file_namestring

    Name der Datei.

  • public_file_mimestring

    MIME-Typ der Datei.

  • public_file_sizeinteger

    Größe der Datei in Bytes.

  • public_durationinteger

    Dauer von Audio oder Video in Sekunden.

  • public_dimension_xinteger

    Breite des Bildes oder Videos in Pixel.

  • public_dimension_yinteger

    Höhe des Bildes oder Videos in Pixeln.

  • public_datestring (date-time)

    Veröffentlichungsdatum der Datei.

  • public_orderinteger

    Reihenfolge der Datei innerhalb ihrer Gruppe.

  • public_episode_typestring

    Episodentyp für Podcasts, zum Beispiel full oder trailer.

  • public_seasonstring

    Staffel für Podcasts.

  • generated_id3boolean

    ID3-Tags wurden aus der Datei erzeugt.

  • guidstring

    Global eindeutige ID der Datei, in Feeds verwendet.

  • display_start_hourinteger

    Stunde, ab der die Datei angezeigt wird.

  • display_end_hourinteger

    Stunde, bis zu der die Datei angezeigt wird.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/media/media/42/file \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "public_title": "Beispiel",
  "public_description": "Text",
  "public_file_url": "https://vynst.de",
  "public_file_name": "Beispiel",
  "media_file_type": "string",
  "archived": true,
  "public_subtitle": "string"
}

MediaFileInfo aktualisieren

PUT/api/media/media/{fileIdentifier}/file

Pfad-Parameter

fileIdentifierPflichtstring

Request-Body application/json

  • dataMediaFileInfo2

Antworten

200MediaFileInfo aktualisierenMediaFileInfo

Felder anzeigen (31)
  • idinteger

    Primärschlüssel der Mediendatei. Interne ID.

  • media_file_typestring

    Art der Mediendatei, zum Beispiel Audio, Video oder Bild.

  • archivedboolean

    Die Datei ist archiviert.

  • namestring

    interner Name

  • descriptionstring

    interne Beschreibung

  • public_titlestring

    Titel, der öffentlich angezeigt wird.

  • public_subtitlestring

    Untertitel, der öffentlich angezeigt wird.

  • public_linkstring

    Öffentlicher Link zur Datei.

  • public_authorstring

    Öffentlich angezeigter Autor.

  • public_summarystring

    Kurze Zusammenfassung, die öffentlich angezeigt wird.

  • public_descriptionstring

    Beschreibung, die öffentlich angezeigt wird.

  • public_explicitboolean

    Der Inhalt ist als explizit gekennzeichnet.

  • public_thumbnailstring

    URL der Vorschau.

  • public_keywordsstring

    Schlüsselwörter der Datei.

  • public_file_urlstring

    URL der Datei.

  • public_file_namestring

    Name der Datei.

  • public_file_mimestring

    MIME-Typ der Datei.

  • public_file_sizeinteger

    Größe der Datei in Bytes.

  • public_durationinteger

    Dauer von Audio oder Video in Sekunden.

  • public_dimension_xinteger

    Breite des Bildes oder Videos in Pixel.

  • public_dimension_yinteger

    Höhe des Bildes oder Videos in Pixeln.

  • public_datestring (date-time)

    Veröffentlichungsdatum der Datei.

  • public_orderinteger

    Reihenfolge der Datei innerhalb ihrer Gruppe.

  • public_episode_typestring

    Episodentyp für Podcasts, zum Beispiel full oder trailer.

  • public_seasonstring

    Staffel für Podcasts.

  • generated_id3boolean

    ID3-Tags wurden aus der Datei erzeugt.

  • guidstring

    Global eindeutige ID der Datei, in Feeds verwendet.

  • display_start_hourinteger

    Stunde, ab der die Datei angezeigt wird.

  • display_end_hourinteger

    Stunde, bis zu der die Datei angezeigt wird.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/media/media/42/file \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '{}'
Antwort 200 application/json
{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "public_title": "Beispiel",
  "public_description": "Text",
  "public_file_url": "https://vynst.de",
  "public_file_name": "Beispiel",
  "media_file_type": "string",
  "archived": true,
  "public_subtitle": "string"
}

MediaFileInfo aktualisieren

PATCH/api/media/media/{fileIdentifier}/file

Pfad-Parameter

fileIdentifierPflichtstring

Request-Body application/json

  • dataMediaFileInfo2

Antworten

200MediaFileInfo aktualisierenMediaFileInfo

Felder anzeigen (31)
  • idinteger

    Primärschlüssel der Mediendatei. Interne ID.

  • media_file_typestring

    Art der Mediendatei, zum Beispiel Audio, Video oder Bild.

  • archivedboolean

    Die Datei ist archiviert.

  • namestring

    interner Name

  • descriptionstring

    interne Beschreibung

  • public_titlestring

    Titel, der öffentlich angezeigt wird.

  • public_subtitlestring

    Untertitel, der öffentlich angezeigt wird.

  • public_linkstring

    Öffentlicher Link zur Datei.

  • public_authorstring

    Öffentlich angezeigter Autor.

  • public_summarystring

    Kurze Zusammenfassung, die öffentlich angezeigt wird.

  • public_descriptionstring

    Beschreibung, die öffentlich angezeigt wird.

  • public_explicitboolean

    Der Inhalt ist als explizit gekennzeichnet.

  • public_thumbnailstring

    URL der Vorschau.

  • public_keywordsstring

    Schlüsselwörter der Datei.

  • public_file_urlstring

    URL der Datei.

  • public_file_namestring

    Name der Datei.

  • public_file_mimestring

    MIME-Typ der Datei.

  • public_file_sizeinteger

    Größe der Datei in Bytes.

  • public_durationinteger

    Dauer von Audio oder Video in Sekunden.

  • public_dimension_xinteger

    Breite des Bildes oder Videos in Pixel.

  • public_dimension_yinteger

    Höhe des Bildes oder Videos in Pixeln.

  • public_datestring (date-time)

    Veröffentlichungsdatum der Datei.

  • public_orderinteger

    Reihenfolge der Datei innerhalb ihrer Gruppe.

  • public_episode_typestring

    Episodentyp für Podcasts, zum Beispiel full oder trailer.

  • public_seasonstring

    Staffel für Podcasts.

  • generated_id3boolean

    ID3-Tags wurden aus der Datei erzeugt.

  • guidstring

    Global eindeutige ID der Datei, in Feeds verwendet.

  • display_start_hourinteger

    Stunde, ab der die Datei angezeigt wird.

  • display_end_hourinteger

    Stunde, bis zu der die Datei angezeigt wird.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request PATCH \
  --url https://eure-instanz.iw-erp.de/api/media/media/42/file \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '{}'
Antwort 200 application/json
{
  "id": 42,
  "name": "Beispiel",
  "description": "Text",
  "public_title": "Beispiel",
  "public_description": "Text",
  "public_file_url": "https://vynst.de",
  "public_file_name": "Beispiel",
  "media_file_type": "string",
  "archived": true,
  "public_subtitle": "string"
}

Liefert eine Liste der Mediendateien einer einzelnen Medien-Gruppe.

GET/api/media/mediagroup/{groupIdentifier}/entries

Pfad-Parameter

groupIdentifierPflichtstring

Query-Parameter

namestringinterner Name | Erforderliches Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicTitlestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicSubtitlestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicKeywordsstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicDatestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicOrderstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicSeasonstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
publicFileMimestringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
addonData_customFilterstringErfordert Zugriffsrecht: PUBLIC, LOGGED_IN, SCOPE
archivedboolean
generatedId3boolean
idinteger
createdstring
updatedstring
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 Mediendateien einer einzelnen Medien-Gruppe.array<MediaFileInfo3>

Felder anzeigen (26)
  • idinteger

    Primärschlüssel der Mediendatei. Interne ID.

  • media_file_typestring

    Art der Mediendatei, zum Beispiel Audio, Video oder Bild.

  • public_titlestring

    Titel, der öffentlich angezeigt wird.

  • public_subtitlestring

    Untertitel, der öffentlich angezeigt wird.

  • public_linkstring

    Öffentlicher Link zur Datei.

  • public_authorstring

    Öffentlich angezeigter Autor.

  • public_summarystring

    Kurze Zusammenfassung, die öffentlich angezeigt wird.

  • public_descriptionstring

    Beschreibung, die öffentlich angezeigt wird.

  • public_explicitboolean

    Der Inhalt ist als explizit gekennzeichnet.

  • public_thumbnailstring

    URL der Vorschau.

  • public_keywordsstring

    Schlüsselwörter der Datei.

  • public_file_namestring

    Name der Datei.

  • public_file_mimestring

    MIME-Typ der Datei.

  • public_file_sizeinteger

    Größe der Datei in Bytes.

  • public_durationinteger

    Dauer von Audio oder Video in Sekunden.

  • public_dimension_xinteger

    Breite des Bildes oder Videos in Pixel.

  • public_dimension_yinteger

    Höhe des Bildes oder Videos in Pixeln.

  • public_datestring (date-time)

    Veröffentlichungsdatum der Datei.

  • public_orderinteger

    Reihenfolge der Datei innerhalb ihrer Gruppe.

  • public_episode_typestring

    Episodentyp für Podcasts, zum Beispiel full oder trailer.

  • public_seasonstring

    Staffel für Podcasts.

  • guidstring

    Global eindeutige ID der Datei, in Feeds verwendet.

  • display_start_hourinteger

    Stunde, ab der die Datei angezeigt wird.

  • display_end_hourinteger

    Stunde, bis zu der die Datei angezeigt wird.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/media/mediagroup/42/entries \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "id": 42,
    "public_title": "Beispiel",
    "public_description": "Text",
    "public_file_name": "Beispiel",
    "media_file_type": "string",
    "public_subtitle": "string",
    "public_link": "string",
    "public_author": "string",
    "public_summary": "string",
    "public_explicit": true
  }
]