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.
The format of input data is specified in the HTTP Content-Type
header.
Acceptable header values: application/x-yametrika+json
or application/json
.
Format of results
The Management API returns responses in UTF-8 encoding. Responses are in JSON format.
For example, the following request returns information about the app with the 1111 ID:
GET /management/v1/application/1111 HTTP/1.1
Host: api.appmetrica.yandex.ru
Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037
Response example:
{
"application": {
"name": "Examples api.yandex.ru",
"time_zone_name": "Europe/Moscow",
"hide_address": false,
"gdpr_agreement_accepted": false,
"use_universal_links": false,
"id": 1111,
"uid": 178121744,
"owner_login": "login",
"time_zone_offset": 10800,
"create_date": "2016-01-02"
}
}
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 /management/v1/application/1111?pretty=1 HTTP/1.1
Host: api.appmetrica.yandex.ru
Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037
When DELETE methods are executed successfully, the API returns the HTTP status with the code 200
. If the HTTP status contains a different code, deletion was not performed.
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.