Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Die Rest Services können über folgenden Pfad aufgerufen werden:

http://[jEDHOC-Server]/restservices/[Service Path]

Authentifizierung

RestserviceBeschreibungMethodeParameterExample

/authentication/login

@Deprecated

Erstellt eine User SessionPOST

Query Param:

  • username: String
  • password: String


Code Block
curl -X POST \
--location "https://jedhoc.example.org:8443/restservices/authentication/login?username=username&password=password" \
-H "Content-Type: application/json"


/authentication/login/formErstellt eine User SessionPOST

Form Param:

  • username: String
  • password: String


Code Block
languagebash
curl -X POST \
--location "https://jedhoc.example.org:8443/restservices/authentication/login/form" \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'username=username' \
--data-urlencode 'password=password'


...

Expand
titlePOST /upload/{sessionid}

Upload einer Datei über die REST-Api. Die Daten werden als Octet-Stream mitgeschickt.

Parameters

NameTypInRequiredBeschreibung
sessionidstringpath(tick)Die Session ID, die bei der Authentifizierung zurückgegeben wurde.
fileNamestringquery
Der Dateiname
secretbooleanquery

Soll ein Passwort generiert werden?

Default: false

mailarray[string]query(tick)Die Empfänger des Uploads.
commentstringquery
Ein Kommentar
sendMailbooleanquery
Sollen Mails versendet werden?
Default: true

Example

Code Block
curl -X POST --location "https://localhostjedhoc.example.org:8443/restservices/upload/34685fd3-fefa-4c5b-801d-fcfa98671613?fileName=example.jpg&mail=user1@example.org&mail=user2@example.org&comment=Comment&secret=true" \
    -H "Content-Type: application/octet-stream" \
    -d @\tmp\example.jpg

Responses

Code Block
HTTP/1.1 200 OK
Date: Fri, 04 Mar 2022 09:48:46 GMT
X-Frame-Options: SAMEORIGIN
Strict-Transport-Security: max-age=31536000; includeSubDomains
Content-Type: application/json
Transfer-Encoding: chunked

{
  "_embedded": {
    "jedhocFile": {
      "hash": "12a2af26-a274-478f-abaa-1e3640e814c8",
      "name": "example.jpg",
      "password": "n7QllGYI",
      "upDate": "2022-03-04T09:48:46.110+0000",
      "endDate": "2022-03-11T09:48:46.110+0000",
      "comment": "Comment",
      "active": true,
      "_links": {
        "download": {
          "href": "https://jedhoc.example.org:8443/download/12a2af26-a274-478f-abaa-1e3640e814c8"
        }
      }
    }
  }
}


...