Skip to main content
Version: API v1

Neues Access-Token erstellen

POST/v1/authentication/tokens/
API version
v1
Request method
POST
Operation ID
createApplicationToken

Erstellt ein neues Access-Token (auch „Application-Token“ genannt). Der Token-Wert wird serverseitig generiert (sofern kein eigener Wert im Feld token vorgegeben wird) und ist ausschließlich in der Antwort dieses Aufrufs lesbar. uuid und token der Antwort können anschließend am /authenticate-Endpunkt als username/password verwendet werden.

Request​

Responses​

Format
application/json
Description

Access-Token erstellt

  • uuidstring (uuid)
    required

    Die "ID" des Tokens. Diese ist bei späteren Authentifizierungsvorgängen als Nutzername zu verwenden.

  • crdateinteger
    required

    Das Erstelldatum als Unix-Timestamp (Sekunden).

  • tokenstring (password)
    required

    Der "geheime" Teil des Tokens. Dieser ist bei späteren Authentifzierungsvorgängen als Passwort zu benutzen; außer in der initialen Antwort nach Erstellen des Tokens ist kein lesender Zugriff mehr auf diesen Wert möglich.

  • descriptionstring

    Der frei wählbare Beschreibungstext des Tokens, der zuvor vom Benutzer vorgegeben wurde.

Usage examples​

$ curl \
    --fail \
    --location \
    -X POST \
    -d '{"description":"string","token":"string"}' \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    -H 'Content-Type: application/json' \
    https://api.mittwald.de/v1/authentication/tokens