# wp_send_json()

URL: https://chugunov.pro/api-wordpress/functions/wp_send_json/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.5.0.

## Сигнатура

```php
wp_send_json( mixed $response, int $status_code = null, int $flags )
```

## Описание

Отправляет JSON-ответ на Ajax-запрос.

## Параметры

- `$response` `mixed` — обязательный. Переменная (обычно массив или объект) для кодирования в JSON, последующего вывода и завершения.
- `$status_code` `int` — необязательный, по умолчанию `null`. Код состояния HTTP для вывода.
- `$flags` `int` — необязательный. Опции, передаваемые в json_encode(). Значение по умолчанию 0.

## Исходный код

Файл: `wp-includes/functions.php:4540`

```php
function wp_send_json( $response, $status_code = null, $flags = 0 ) {
	if ( wp_is_serving_rest_request() ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: 1: WP_REST_Response, 2: WP_Error */
				__( 'Return a %1$s or %2$s object from your callback when using the REST API.' ),
				'WP_REST_Response',
				'WP_Error'
			),
			'5.5.0'
		);
	}

	if ( ! headers_sent() ) {
		header( 'Content-Type: application/json; charset=' . get_option( 'blog_charset' ) );
		if ( null !== $status_code ) {
			status_header( $status_code );
		}
	}

	echo wp_json_encode( $response, $flags );

	if ( wp_doing_ajax() ) {
		wp_die(
			'',
			'',
			array(
				'response' => null,
			)
		);
	} else {
		die;
	}
}
```

## История изменений

- 5.6.0 — The $flags parameter was added.
- 4.7.0 — The $status_code parameter was added.
- 3.5.0 — Introduced.

## Связанные

Использует: [`wp_is_serving_rest_request`](https://chugunov.pro/api-wordpress/functions/wp_is_serving_rest_request/), [`wp_doing_ajax`](https://chugunov.pro/api-wordpress/functions/wp_doing_ajax/), [`status_header`](https://chugunov.pro/api-wordpress/functions/status_header/), [`wp_json_encode`](https://chugunov.pro/api-wordpress/functions/wp_json_encode/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`_doing_it_wrong`](https://chugunov.pro/api-wordpress/functions/_doing_it_wrong/), [`wp_die`](https://chugunov.pro/api-wordpress/functions/wp_die/), [`get_option`](https://chugunov.pro/api-wordpress/functions/get_option/).
Используется в: [`wp_ajax_heartbeat`](https://chugunov.pro/api-wordpress/functions/wp_ajax_heartbeat/), [`wp_ajax_nopriv_heartbeat`](https://chugunov.pro/api-wordpress/functions/wp_ajax_nopriv_heartbeat/), [`wp_send_json_success`](https://chugunov.pro/api-wordpress/functions/wp_send_json_success/), [`wp_send_json_error`](https://chugunov.pro/api-wordpress/functions/wp_send_json_error/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_send_json/
