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.

  • crdateintegerrequired

    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.

Content-Type: application/json

{
  "uuid": "f0f86186-0a5a-45b2-aa33-502777496347",
  "crdate": 123,
  "token": "string",
  "description": "string"
}
{
  "title": "ApplicationTokenResponse",
  "required": [
    "crdate",
    "token",
    "uuid"
  ],
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Die \"ID\" des Tokens. Diese ist bei späteren Authentifizierungsvorgängen als Nutzername zu verwenden.\n",
      "format": "uuid"
    },
    "crdate": {
      "type": "integer",
      "description": "Das Erstelldatum als Unix-Timestamp (Sekunden).\n"
    },
    "token": {
      "type": "string",
      "description": "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.\n",
      "format": "password"
    },
    "description": {
      "type": "string",
      "description": "Der frei wählbare Beschreibungstext des Tokens, der zuvor vom Benutzer vorgegeben wurde.\n"
    }
  }
}

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

On this page