WP-API / docs

The content for developer.wordpress.org/rest-api
https://developer.wordpress.org/rest-api
110 stars 615 forks source link

Please provide correct endpoints in the REST API docs #112

Open AbrahamBrookes opened 3 years ago

AbrahamBrookes commented 3 years ago

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

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.