Interface for messages with machine-readable data for use by the API. More...

Inheritance diagram for IApiMessage:

[legend]

Collaboration diagram for IApiMessage:

Public Member Functions
	getApiCode ()
	Returns a machine-readable code for use by the API. More...

	getApiData ()
	Returns additional machine-readable data about the error condition. More...

	setApiCode ( $code, array $data=null)
	Sets the machine-readable code for use by the API. More...

	setApiData (array $data)
	Sets additional machine-readable data about the error condition. More...

Public Member Functions inherited from MessageSpecifier
	getKey ()
	Returns the message key. More...

	getParams ()
	Returns the message parameters. More...

Detailed Description

Interface for messages with machine-readable data for use by the API.

The idea is that it's a Message that has some extra data for the API to use when interpreting it as an error (or, in the future, as a warning). Internals of MediaWiki often use messages (or message keys, or Status objects containing messages) to pass information about errors to the user (see e.g. Title::getUserPermissionsErrors()) and the API has to make do with that.

Since: 1.25

Definition at line 35 of file ApiMessage.php.

Member Function Documentation

◆ getApiCode()

IApiMessage::getApiCode ( )

Returns a machine-readable code for use by the API.

If no code was specifically set, the message key is used as the code after removing "apiwarn-" or "apierror-" prefixes and applying backwards-compatibility mappings.

Returns: string

◆ getApiData()

IApiMessage::getApiData ( )

Returns additional machine-readable data about the error condition.

Returns: array

◆ setApiCode()

IApiMessage::setApiCode	(		$code,
		array	$data = `null`
	)

Sets the machine-readable code for use by the API.

Parameters

string \| null	$code	If null, uses the default (see self::getApiCode())
array \| null	$data	If non-null, passed to self::setApiData()

Referenced by ApiMessage\__construct(), and ApiRawMessage\__construct().

◆ setApiData()

IApiMessage::setApiData ( array $data )

Sets additional machine-readable data about the error condition.