The code for the API unit tests largely preceded much of our modern

codebase standards. It lacked docs, certainly lacked typing, and has a

lot of design choices that limit future expansion.
In preparation for new API work that will be taking place, this change

cleans up this code, adding typing and docs and assertions to ensure

that we have a better foundation for building more manageable test

suites going forward.

Unit tests pass.