August 15, 2022
ISSUE #
29

Introducing the Herald Request Builder

New updates and improvements to Herald's API.

The Herald Request Builder

Today we’re launching the Herald Request Builder (HeRB), an interactive demonstration of our dynamic application with real-time API requests.

The Herald Request Builder is a fully interactive demo of our application, submission, and quote endpoints. Each step has a front-end editor and JSON payload, all pulling from our APIs sandbox environment in real time.

Herald customers can access HeRB with their sandbox token to:

  • Create real sandbox applications for their products
  • Demo real-time conditionality of risk and coverage parameters
  • Retrieve test quotes
  • And more, all while viewing the actual API requests and responses.

You can learn more about HeRB in our docs.

Features and Improvements

While building HeRB, we had the opportunity to build a front-end with our own API. During the process we found some room for improvement. Here’s some of the updates we made to our API while building HeRB:

  • We’re now returning [.h-code]text[.h-code] for coverage parameters in the quote response, so customers can easily show all coverages and limits associated with a quote.
  • We changed the risk parameter for domain to a [.h-code]string[.h-code] that can have multiple values. Previously domain was an array for multiple domains.
  • We’re now including [.h-code]creates_array: false[.h-code], which was previously only a relevant property when [.h-code]true[.h-code].
  • We added an error message when submitting a partially completed address without required fields, like city or state.

Additional Fixes

  • Fixed a bug for dates set in the past, mapping them to a date in the future to prevent inactive quotes.
  • Enhanced some of our Cyber integrations to support 5 optional coverages, including website media content liability and hardware replacement cost.
  • Updated our Quote response to include the same coverages for every product. The quote response now contains coverages as null that were previously not present in the response at all.