The REST API docs give endpoints and an explanation around how they work, but nowhere in the docs does it mention that you need to prepend your endpoints with /wp-json/.
For instance in the table on this page the endpoints are shown:
That list tells me I need to use www.domain.com/wp/v2/posts when in reality I need to use www.domain.com/wp-json/wp/v2/posts
I just faffed about for several hours wondering why the endpoint I was using direct from the endpoints index at www.domain.com/wp-json was giving me a 404, turns out I needed some esoteric, unexplained, internal knowledge about the API in order to perform a basic task.
Please make this much clearer in the docs - ideally by including it in any example endpoints you provide.
The REST API docs give endpoints and an explanation around how they work, but nowhere in the docs does it mention that you need to prepend your endpoints with
/wp-json/
.For instance in the table on this page the endpoints are shown:![image](https://user-images.githubusercontent.com/8340776/121968247-4f692e80-cdb5-11eb-8a4d-d6948f7e74c6.png)
That list tells me I need to use
www.domain.com/wp/v2/posts
when in reality I need to usewww.domain.com/wp-json/wp/v2/posts
I just faffed about for several hours wondering why the endpoint I was using direct from the endpoints index at
www.domain.com/wp-json
was giving me a 404, turns out I needed some esoteric, unexplained, internal knowledge about the API in order to perform a basic task.Please make this much clearer in the docs - ideally by including it in any example endpoints you provide.