Changes to class-wp-json-posts.php for documentation and error handling.

The "number" argument returns an error when called through the filter, but "posts_per_page" works. This change simply updates the documentation.