rest_do_request( WP_REST_Request|string $request )

Do a REST request.

Contents

Description Description

Used primarily to route internal requests through WP_REST_Server.

Parameters Parameters

$request

(WP_REST_Request|string) (Required) Request.

Top ↑

Return Return

(WP_REST_Response) REST response.

Top ↑

Source Source

File: wp-includes/rest-api.php 

function rest_do_request( $request ) {
	$request = rest_ensure_request( $request );
	return rest_get_server()->dispatch( $request );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
4.4.0 Introduced.

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/rest-api.php: rest_preload_api_request()

Append result of internal request to REST API for purpose of preloading data to be attached to a page.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    Contributed by Ryan McCue —

    rest_do_request can be used to internally send a REST API request and return the response object for it. You need to create the Request object first.

    $request = new WP_REST_Request( 'GET', '/wp/v2/posts' );
$response = rest_do_request( $request );

if ( $response->is_error() ) {
	// Convert to a WP_Error object.
	$error = $response->as_error();
	$message = $response->get_error_message();
	$error_data = $response->get_error_data();
	$status = isset( $error_data['status'] ) ? $error_data['status'] : 500;
	wp_die( printf( '<p>An error occurred: %s (%d)</p>', $message, $error_data ) );
}

$data = $response->get_data();
$headers = $response->get_headers();
echo "<p>Success! Here's the data:</p>";
var_dump( $data );

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.