Hinterlegen von neuen application-Tokens

POST/authentication/tokens/

API version

v1

Request method

POST

Operation ID

createApplicationToken

---

Diese Operation ermöglicht es neue Application-Tokens zu hinterlegen.

Request

Responses

Format

application/json

Beschreibung

Application-Token hinterlegt

Schema-Dokumentation

• uuidstring (uuid)

  required

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

• crdatestring (date-time)

  required

  Das Erstelldatum als ISO 8601-Zeitstempel.

• 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.

Beispiel

{
  "uuid": "f0f86186-0a5a-45b2-aa33-502777496347",
  "crdate": "2024-11-22T00:33:25.665Z",
  "token": "string",
  "description": "string"
}

JSON Schema

{
  "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": "string",
      "description": "Das Erstelldatum als ISO 8601-Zeitstempel.\n",
      "format": "date-time"
    },
    "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

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