Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Standard Response Object

Unless otherwise noted in the documentation for a REST API, all ServiceMobility REST API calls return the following standard JSON response object:

On this page:

Standard Response Object Formats

JSON Format 
{
	"type": "",
	"title": "",
	"status": 200,
	"detail": "",
	"invalidParams": [
		{
			"name": "",
			"reason": "",
			"path": "",
			"value": ""
		}
	]
}

Standard Response Object Properties

PropertyTypeDescription
typestringWhen the REST API response is an error, specifies a URI to a description of the error type, to help developers with debugging errors.
titlestringWhen the REST API response is an error, specifies a short, human-readable summary of the problem type.
statusintegerSpecifies the HTTP status code of the response (both for success and error).
detailstringWhen the REST API response is an error, specifies a human-readable explanation specific to the occurrence of the problem. This field may not always be present.
invalidParamsarray

When the REST API response is an error, specifies an array, containing a list of objects, where each object describes specific parameters that were invalid in the request that caused the error. This field may not always be present.

Each object in the array has a format as shown above, with the following properties:

PropertyTypeDescription
namestring

The name of the invalid parameter.

reasonstring

A human-readable explanation of why the parameter was invalid.

pathstringThe JSON path of the invalid parameter.
valuestringThe value of the invalid parameter.
  • No labels