Prüfsummen für DELETEs

Für Operationen, die keine Anforderungs-Nutzdaten zulassen, können Prüfsummen im Anforderungs-Header angegeben werden. Dies gilt für DELETEs und eine kleine Anzahl von POSTs für Geschäftsaktionen, die keine Anforderungs-Nutzdaten zulassen.

Der Headerschlüssel für eine Prüfsumme ist GW-Checksum. Eine in dem Header angegebene Prüfsumme gilt nur für die Stammressource.

Prüfsumme in einem Anforderungskopf mit Postman senden

Warum und wann dieser Vorgang ausgeführt wird

Sie können Prüfsummen in Anforderungsheadern senden, die von Postman ausgeführt werden.

Prozedur

  1. Starten Sie in Postman eine neue Anforderung, indem Sie auf das + rechts neben der Registerkarte Launchpad klicken.
  2. Geben Sie die entsprechende Autorisierung an.
  3. Fügen Sie die Prüfsumme zur Kopfzeile hinzu.
    • Klicken Sie in der ersten Zeile der Registerkarten (die mit Params beginnt) auf Headers.
    • Scrollen Sie zum Ende der bestehenden Schlüssel-/Wertliste.
    • Geben Sie in die leere Zeile am unteren Rand der Schlüssel-/Wertliste Folgendes ein:
      • KEY: GW-Prüfsumme
      • WERT: <checksum value>
  4. Geben Sie den Anforderungsvorgang und die URL ein.
  5. Klicken Sie auf Senden.

Ergebnisse

Die Antwort wird unterhalb der Anforderung angezeigt. Abhängig vom angegebenen Prüfsummenwert enthält die Antwort entweder einen Erfolgscode oder eine Fehlermeldung.

Lernprogramm: Löschen einer Notiz mithilfe von Prüfsummen

In diesem Lernprogramm wird davon ausgegangen, dass Sie Postman in Ihrer Umgebung mit dem korrekten Beispieldatensatz eingerichtet haben. Weitere Informationen finden Sie unter Lernprogramm: Einrichten Ihrer Postman-Umgebung.

In diesem Tutorial werden Sie Aufrufe als Elizabeth Lee (Benutzername elee) senden. In der Basiskonfiguration ist Elizabeth Lee eine Managerin, die über die Berechtigung verfügt, Notizen zu löschen. Als Elizabeth Lee erstellen Sie eine Notiz. Sie versuchen dann, die Notiz zweimal zu LÖSCHEN. Beide DELETEs enthalten einen Prüfsummenwert. Das erste DELETE schlägt fehl und das zweite ist erfolgreich.

Schritte des Lernprogramms

  1. Erstellen Sie in Postman eine erste Anforderung durch:
    1. Klicken Sie auf das + rechts neben der Registerkarte Launchpad.
    2. Geben Sie als Basic Auth-Autorisierung den Benutzer elee und das Kennwort gw an.
  2. Geben Sie den folgenden Aufruf ein, klicken Sie aber noch nicht auf Senden:
    1. POST http://localhost:8080/cc/rest/common/v1/activities/cc:20/notes
  3. Geben Sie die Anforderungs-Nutzdaten an.
    1. Klicken Sie in der ersten Zeile der Registerkarten (die mit Params beginnt) auf Body.
    2. Wählen Sie in der Optionsfeldzeile raw aus.
    3. Ändern Sie am Ende der Zeile mit den Optionsfeldern den Wert der Dropdown-Liste von Text in JSON.
    4. Kopieren Sie Folgendes in das Textfeld unter den Optionsfeldern.
      {
  "data":
    {
      "attributes": {
        "body": "API tutorial note to be deleted with a checksum"
      }
    }
}
  4. Klicken Sie auf Senden. Geben Sie in den Antwort-Nutzdaten die ID und den Prüfsummenwert der Notiz an.
  5. Erstellen einer zweiten Anforderung durch:
    1. Klicken Sie auf das + rechts neben der Registerkarte Launchpad.
    2. Geben Sie als Basic Auth-Autorisierung den Benutzer elee und das Kennwort gw an.
  6. Geben Sie den folgenden Aufruf ein, klicken Sie aber noch nicht auf Senden:
    1. DELETE http://localhost:8080/cc/rest/common/v1/notes/<noteID>
  7. Prüfsumme zur Kopfzeile hinzufügen
    1. Klicken Sie in der ersten Zeile der Registerkarten (die mit Params beginnt) auf Headers.
    2. Scrollen Sie zum Ende der bestehenden Schlüssel-/Wertliste.
    3. Geben Sie in die leere Zeile am unteren Rand der Schlüssel-/Wertliste Folgendes ein:
      • KEY: GW-Prüfsumme
      • WERT: 99
  8. Klicken Sie auf Senden. Der Prüfsummenwert in der Kopfzeile stimmt nicht mit dem Prüfsummenwert für die Notiz überein, der durch ClaimCenter berechnet wird. Daher ist das Löschen fehlgeschlagen und es wird eine Fehlermeldung angezeigt.
  9. Ändern Sie den Prüfsummenwert so, dass er dem Wert aus den POST-Nutzdaten entspricht.
  10. Klicken Sie ein zweites Mal auf Senden. Nun stimmt der Prüfsummenwert im Kopf mit dem Prüfsummenwert für die Notiz überein, der durch ClaimCenter berechnet wird. DELETE ist also erfolgreich.