APIs need to be explored. Documentation helps, but seeing live data flowing through them helps even more.
An example of interactively exploring and documenting the GitHub API.
Working with Postgres from the development environment
Visualizing a Postgres database from the inspector