rest: Improve tests and documention of /headers and /block

Summary: This is a backport of Core PR15177

Test Plan: ninja && test/functional/test_runner.py interface_rest

Reviewers: #bitcoin_abc, majcosta

Reviewed By: #bitcoin_abc, majcosta

Differential Revision: https://reviews.bitcoinabc.org/D8355