WP-API / docs

The content for developer.wordpress.org/rest-api

Home Page:https://developer.wordpress.org/rest-api

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Please provide correct endpoints in the REST API docs

AbrahamBrookes opened this issue · comments

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.