Update docs

@lob/api-engineering-lobsters ready for review. I kept the API.md separate but can merge it if that seems better to you guys. IMO, easier to read this way.
can you structure this like if (err) console.log(err) else...