Abrufen von Ressourcen für ein bestimmtes Datum

In einigen Situationen muss ein System-API-Aufruf möglicherweise eine gültig-datierte Ressource für ein bestimmtes Datum abrufen. So muss ein GET beispielsweise die Police pc:10 nicht so abrufen, wie sie heute existiert, sondern so, wie sie am 1. Januar 2019 existierte. Um dies zu erreichen, unterstützen mehrere Job- und Policenendpunkte den Parameter asOfDate. Mit diesem Parameter können Sie Daten zu einer Ressource abrufen, wie sie zu einem bestimmten Zeitpunkt vorhanden war. Die Syntax lautet:

?asOfDate=dateValue

Die folgende Abfrage gibt beispielsweise die Police pc:10 zurück: wie sie am 1. Januar 2019 existierte:

GET /policies/pc:10?asOfDate=2019-01-01

Wenn Sie eine Police zu einem Zeitpunkt abfragen, der vor deren Datum des Inkrafttretens liegt oder nach deren Ablaufdatum liegt, erhalten Sie eine BadInputException mit der folgenden Benutzermeldung: "Bad value for the 'asOfDate' query parameter - No branch found for date 01/01/2019 12:00 AM".