Eine Tag-Information hinzufügen¶
Note
Wenn die optionalen Attribute nicht gesetzt sind, setzt das System einen Standardwert ein.
Note
Der Body enthält die Attribute id, created und modified nicht. Die Werte dieser Attribute werden vom System nach dem Erstellen des Eintrags gesetzt.
Senden einer POST-Anfrage an den Endpunkt /tags/{tagId}/information.
Beschreibung¶
Mit der Add-Tag-Information-Anfrage fügen Sie eine oder mehrere Tag-Informationen hinzu, um globale Kommentare zu Ihren Domains oder Subdomains der Organisation zu ergänzen.
Voraussetzungen¶
Werte der Anfrage: Tag-ID {id}
Objekte: TagInformationVO
Anfrage¶
Um einem Tag eine Tag-Information hinzuzufügen, fügen Sie die Tag-ID {id} dem Pfad der HTTP-Anfrage hinzu.
Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen einer Tag-Information erforderlich sind, müssen im Body ein oder mehrere Objekte TagInformationVO mit den folgenden Attributen definiert werden:
| Attribut | Beschreibung | Werte |
|---|---|---|
key |
Der Name des Keys. | string |
value |
Der Wert des Keys. | string |
comment |
Ein individueller Kommentar für den Eintrag. | string |
Das System gibt als Antwort das Objekt TagInformationVO mit den Informationen zum neuen Eintrag zurück.
Beispiel¶
Beispiel-Request-Body:
Antworten¶
Die folgenden Antworten sind möglich:
| STATUSCODE | BESCHREIBUNG |
|---|---|
| 201 | Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt. |
| 400 | Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen. |
| 401 | Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war. |
| 403 | Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen. |