更改返回的WP Rest API JSON响应格式

要更改WordPress REST API返回的JSON响应格式，你需要深入了解WordPress的REST API系统以及如何通过自定义来实现你的需求。以下是基础概念、相关优势、类型、应用场景以及如何解决这个问题的详细解答。

基础概念

WordPress REST API（WP REST API）是一个内置的API，允许开发者通过HTTP请求与WordPress网站进行交互。它返回的数据通常是JSON格式，包含了网站的各种信息，如文章、页面、用户等。

类型

标准响应：默认的JSON格式。
自定义响应：根据特定需求调整的JSON格式。

应用场景

移动应用开发：需要特定的数据结构来优化用户体验。
第三方集成：与其他服务或平台的数据交换。
数据分析工具：需要特定格式的数据来进行分析。

如何更改响应格式

以下是一个简单的示例，展示如何通过自定义REST API端点来更改返回的JSON响应格式。

步骤1：创建自定义端点

在你的主题的functions.php文件或自定义插件中添加以下代码：

function custom_rest_api_response($data, $request, $server) {
    // 自定义响应格式
    $custom_response = [
        'status' => 'success',
        'data' => $data,
        'timestamp' => current_time('mysql'),
    ];
    return rest_ensure_response($custom_response);
}

function register_custom_endpoint() {
    register_rest_route('custom/v1', '/data', array(
        'methods' => 'GET',
        'callback' => function($request) {
            // 获取标准响应数据
            $response = rest_get_server()->dispatch($request);
            return custom_rest_api_response($response->get_data(), $request, rest_get_server());
        },
        'permission_callback' => '__return_true'
    ));
}
add_action('rest_api_init', 'register_custom_endpoint');