json: follow api naming semantics, cleanup, docs.

bson_json_reader_read() now expects that `bson` is uninitialized.
You should only free it if the result was 1.