Formats for input data and results
Format for input data
Input data structures for POST and PUT methods are passed in the request body. Input structures match the output structures of the GET methods of the corresponding resources.
Note
To properly form the input structure for a POST or PUT method, call the GET method for a resource that already exists. Copy the resulting structure and define all the necessary field values.
The API POST and PUT methods accept input data in JSON format.
You can specify the format of input data in the Content-Type HTTP header.
Possible header values: application/x-yametrika+json or application/json.
Results format
The Management API returns responses in UTF-8 encoding. Responses are in JSON format.
For example, the results for the following request will have information about a counter:
GET https://api-metrika.yandex.net/management/v1/counter/<counter_id>
Example:
POST /management/v1/counters HTTP/1.1
Host: api-metrika.yandex.net
Authorization: OAuth <access_token>
Content-Type: application/x-yametrika+json
Content-Length: 127
{
"counter" : {
"site" : "www.example.com",
"name" : "Counter name",
}
}
For debugging purposes, results can be formatted. To do this, pass the pretty parameter with the value set to 1 in any type of request:
GET https://api-metrika.yandex.net/management/v1/counter/<counter_id>?pretty=1
PUT https://api-metrika.yandex.net/management/v1/counter/<counter_id>?pretty=1
When DELETE methods are successful, the API returns an HTTP 200 status code. If the HTTP status contains a different code, deletion was not performed.