Movizor

https://movizor.ru/docs/ru
Admin
Movizor is a system designed for monitoring and managing various objects and assets, including...
Tokens:8,436
Snippets:32
Trust Score:7
Update:1 year ago
Show doc for...
Tokens:
Raw
### API Key Authentication Example

Source: https://movizor.ru/docs/ru/api-v2/auth

This example demonstrates how to construct an API request using an API key. The API key and project identifier must be passed as GET or POST parameters. Ensure the project parameter is included in the URI.

```HTTP
https://movizor.ru/api_2/mycompany/object_add/?phone=79991112233&title=Test&tariff=4&key=123
```

--------------------------------

### OAuth 2.0 Token Response Example

Source: https://movizor.ru/docs/ru/api-v2/auth

This is an example of the JSON response received after successfully exchanging an OAuth `code` for an access `token`. It includes status, message, and the `token` itself, along with `app_id` and `client_id`.

```JSON
{"code":"OK","message":"Token created","result":"success","data":{"app_id":"1","client_id":"70123","token":"12bf14ce521713adb5bf2cc6416252eb87d7eee23a0ea1b468d4b1e282961a1"}}
```

--------------------------------

### GET /api_2/mycompany/pos_last

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение последнего местоположения конкретного объекта.

```APIDOC
## GET /api_2/mycompany/pos_last

### Description
Этот метод позволяет получить последние известные координаты конкретного объекта. Рекомендуется использовать этот метод периодически (например, каждые 10 минут) при использовании автоматических тарифов.

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/pos_last/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **object_id** (integer) - Required - Идентификатор объекта, для которого нужно получить последнее местоположение.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "object_id": 12345
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (object) - Объект с последним местоположением объекта:
  - **object_id** (integer) - Идентификатор объекта.
  - **phone** (string) - Номер телефона объекта.
  - **title** (string) - Название объекта.
  - **timestamp** (string) - Время определения местоположения.
  - **latitude** (float) - Широта.
  - **longitude** (float) - Долгота.
  - **accuracy** (float) - Точность определения координат.

#### Response Example
```json
{
  "status": "OK",
  "data": {
    "object_id": 12345,
    "phone": "79991234567",
    "title": "Test Object",
    "timestamp": "2023-10-27T10:30:00Z",
    "latitude": 55.7558,
    "longitude": 37.6173,
    "accuracy": 15.0
  }
}
```
```

--------------------------------

### GET /api_2/mycompany/pos_list

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение списка местоположений конкретного объекта за указанный диапазон времени.

```APIDOC
## GET /api_2/mycompany/pos_list

### Description
Этот метод позволяет получить историю местоположений конкретного объекта за заданный временной интервал. Полезно для анализа маршрутов и перемещений.

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/pos_list/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **object_id** (integer) - Required - Идентификатор объекта.
- **from_date** (string) - Required - Начальная дата и время в формате ISO 8601 (например, "2023-10-26T00:00:00Z").
- **to_date** (string) - Required - Конечная дата и время в формате ISO 8601 (например, "2023-10-27T00:00:00Z").

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "object_id": 12345,
  "from_date": "2023-10-26T00:00:00Z",
  "to_date": "2023-10-27T00:00:00Z"
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (array) - Массив записей местоположений, где каждая запись содержит:
  - **timestamp** (string) - Время определения местоположения.
  - **latitude** (float) - Широта.
  - **longitude** (float) - Долгота.
  - **accuracy** (float) - Точность определения координат.

#### Response Example
```json
{
  "status": "OK",
  "data": [
    {
      "timestamp": "2023-10-26T12:00:00Z",
      "latitude": 55.7500,
      "longitude": 37.6000,
      "accuracy": 25.0
    },
    {
      "timestamp": "2023-10-26T12:10:00Z",
      "latitude": 55.7520,
      "longitude": 37.6050,
      "accuracy": 22.0
    }
  ]
}
```
```

--------------------------------

### GET /api_2/mycompany/events

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение списка событий по всему аккаунту.

```APIDOC
## GET /api_2/mycompany/events

### Description
Этот метод позволяет получить список всех событий, зарегистрированных в вашем аккаунте Movizor. Это могут быть уведомления, изменения статусов объектов и другая важная информация.

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/events/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **from_date** (string) - Optional - Начальная дата и время в формате ISO 8601 для фильтрации событий.
- **to_date** (string) - Optional - Конечная дата и время в формате ISO 8601 для фильтрации событий.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "from_date": "2023-10-26T00:00:00Z",
  "to_date": "2023-10-27T00:00:00Z"
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (array) - Массив событий, где каждое событие содержит:
  - **event_id** (integer) - Идентификатор события.
  - **timestamp** (string) - Время события.
  - **event_type** (string) - Тип события.
  - **message** (string) - Описание события.
  - **object_id** (integer, optional) - Идентификатор объекта, к которому относится событие (если применимо).

#### Response Example
```json
{
  "status": "OK",
  "data": [
    {
      "event_id": 1001,
      "timestamp": "2023-10-26T09:00:00Z",
      "event_type": "object_added",
      "message": "Object Test Object 1 added.",
      "object_id": 12345
    },
    {
      "event_id": 1002,
      "timestamp": "2023-10-26T15:30:00Z",
      "event_type": "location_update",
      "message": "New location received for Test Object 2.",
      "object_id": 67890
    }
  ]
}
```
```

--------------------------------

### GET /api_2/mycompany/object_list

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение списка всех объектов и их текущих статусов.

```APIDOC
## GET /api_2/mycompany/object_list

### Description
Этот метод позволяет получить список всех объектов, которые находятся под вашим управлением, а также их текущие статусы.

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/object_list/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (array) - Массив объектов, где каждый объект содержит:
  - **object_id** (integer) - Идентификатор объекта.
  - **phone** (string) - Номер телефона объекта.
  - **title** (string) - Название объекта.
  - **status** (string) - Текущий статус объекта.

#### Response Example
```json
{
  "status": "OK",
  "data": [
    {
      "object_id": 12345,
      "phone": "79991234567",
      "title": "Test Object 1",
      "status": "active"
    },
    {
      "object_id": 67890,
      "phone": "79999876543",
      "title": "Test Object 2",
      "status": "inactive"
    }
  ]
}
```
```

--------------------------------

### GET /api_2/mycompany/pos_objects

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение списка всех объектов с их последними координатами.

```APIDOC
## GET /api_2/mycompany/pos_objects

### Description
Этот метод возвращает список всех объектов, для которых доступны последние известные координаты. Полезно для отображения текущего местоположения всех отслеживаемых объектов.

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/pos_objects/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (array) - Массив объектов, где каждый объект содержит:
  - **object_id** (integer) - Идентификатор объекта.
  - **phone** (string) - Номер телефона объекта.
  - **title** (string) - Название объекта.
  - **last_position** (object) - Последнее известное местоположение:
    - **timestamp** (string) - Время определения местоположения.
    - **latitude** (float) - Широта.
    - **longitude** (float) - Долгота.
    - **accuracy** (float) - Точность определения координат.

#### Response Example
```json
{
  "status": "OK",
  "data": [
    {
      "object_id": 12345,
      "phone": "79991234567",
      "title": "Test Object 1",
      "last_position": {
        "timestamp": "2023-10-27T10:30:00Z",
        "latitude": 55.7558,
        "longitude": 37.6173,
        "accuracy": 15.0
      }
    },
    {
      "object_id": 67890,
      "phone": "79999876543",
      "title": "Test Object 2",
      "last_position": {
        "timestamp": "2023-10-27T10:35:00Z",
        "latitude": 55.7600,
        "longitude": 37.6200,
        "accuracy": 20.0
      }
    }
  ]
}
```
```

--------------------------------

### GET /api_2/mycompany/object_get

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение информации о конкретном объекте, включая его статус и данные аналитики.

```APIDOC
## GET /api_2/mycompany/object_get

### Description
Этот метод позволяет получить подробную информацию о конкретном объекте, включая его текущий статус, данные аналитики (например, населенный пункт, оставшееся расстояние, прогноз успеваемости).

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/object_get/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **object_id** (integer) - Required - Идентификатор объекта.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "object_id": 12345
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (object) - Объект с данными об объекте, включая:
  - **object_id** (integer) - Идентификатор объекта.
  - **phone** (string) - Номер телефона объекта.
  - **title** (string) - Название объекта.
  - **status** (string) - Текущий статус объекта.
  - **location** (string) - Населенный пункт.
  - **distance_remaining** (float) - Оставшееся расстояние.
  - **performance_forecast** (float) - Прогноз успеваемости.

#### Response Example
```json
{
  "status": "OK",
  "data": {
    "object_id": 12345,
    "phone": "79991234567",
    "title": "Test Object",
    "status": "active",
    "location": "Moscow",
    "distance_remaining": 150.5,
    "performance_forecast": 0.95
  }
}
```
```

--------------------------------

### GET /api_2/mycompany/pos_get

Source: https://movizor.ru/docs/ru/api-v2/basic

Получение информации о запросе на определение местоположения и координат объекта по его `request_id`.

```APIDOC
## GET /api_2/mycompany/pos_get

### Description
Этот метод позволяет получить результат запроса на определение местоположения, используя `request_id`, полученный от метода `pos_request`. Ответ содержит информацию о запросе и, если доступно, координаты объекта.

### Method
GET

### Endpoint
`https://movizor.ru/api_2/mycompany/pos_get/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **request_id** (string) - Required - Идентификатор запроса, полученный из метода `pos_request`.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "request_id": "req_abc123def456"
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **data** (object) - Объект с данными о запросе и местоположении, включая:
  - **request_id** (string) - Идентификатор запроса.
  - **object_id** (integer) - Идентификатор объекта.
  - **timestamp** (string) - Время определения местоположения.
  - **latitude** (float) - Широта.
  - **longitude** (float) - Долгота.
  - **accuracy** (float) - Точность определения координат.

#### Response Example
```json
{
  "status": "OK",
  "data": {
    "request_id": "req_abc123def456",
    "object_id": 12345,
    "timestamp": "2023-10-27T10:30:00Z",
    "latitude": 55.7558,
    "longitude": 37.6173,
    "accuracy": 15.0
  }
}
```
```

--------------------------------

### AppChat API - Start Chat

Source: https://movizor.ru/docs/ru/api-v2/appchat-api

Initiates a new chat conversation with a specified user identified by their phone number.

```APIDOC
## POST /appchat/start

### Description
Creates a new chat with a user. The user is identified by their phone number.

### Method
POST

### Endpoint
/appchat/start

### Parameters
#### Request Body
- **phone** (int) - Required - The phone number of the user to start a chat with.
```

--------------------------------

### OAuth 2.0 Code to Token Exchange

Source: https://movizor.ru/docs/ru/api-v2/auth

This example shows how to exchange an authorization `code` for a full API access `token`. This request must be made within 5 minutes of receiving the `code`. The response contains the `token` and other relevant data.

```HTTP
https://movizor.ru/oauth/code/?code=77a04169132674e0
```

--------------------------------

### API Key Authentication

Source: https://movizor.ru/docs/ru/api-v2/auth

Standard method using an API key obtained from the Personal Account. This key should be passed in all HTTP(S) requests as a GET or POST parameter, along with the 'project' parameter.

```APIDOC
## API Key Authentication

### Description
Standard method using an API key obtained from the Personal Account. This key should be passed in all HTTP(S) requests as a GET or POST parameter, along with the 'project' parameter.

### Method
GET/POST

### Endpoint
`https://movizor.ru/api_2/{project_name}/...
`

### Parameters
#### Query Parameters
- **project** (string) - Required - The project name specified in the API access credentials.
- **key** (string) - Required - The API access key.
- **phone** (string) - Required - The phone number for the service connection.
- **title** (string) - Optional - The name of the object.
- **tariffid** (integer) - Optional - The tariff plan ID.

### Request Example
```
https://movizor.ru/api_2/mycompany/object_add/?phone=79991112233&title=Test&tariff=4&key=123
```

### Response
#### Success Response (200)
- **status** (string) - Indicates the status of the operation (e.g., 'OK').
- **message** (string) - A message describing the result of the operation.
- **result** (string) - The outcome of the operation (e.g., 'success').
- **data** (object) - Contains additional data related to the operation.

#### Response Example
```json
{
  "code": "OK",
  "message": "Object added successfully",
  "result": "success",
  "data": {}
}
```
```

--------------------------------

### AppChat API - Get Messages

Source: https://movizor.ru/docs/ru/api-v2/appchat-api

Retrieves all messages from a specified chat, identified by its unique chat key.

```APIDOC
## GET /appchat/messages

### Description
Retrieves messages from a specific chat.

### Method
GET

### Endpoint
/appchat/messages

### Parameters
#### Query Parameters
- **chat_key** (string) - Required - The unique key of the chat from which to retrieve messages.
```

--------------------------------

### API Request with OAuth Token

Source: https://movizor.ru/docs/ru/api-v2/auth

This example shows how to make an API request on behalf of a client using an obtained OAuth `token`. The `token` parameter authenticates the request to the API, indicating that it should be executed within the specified client's account.

```HTTP
https://movizor.ru/api_2/app/object_add/?phone=79991112233&title=Test&tariff=4&token=12bf14ce521713adb5bf2cc6416252eb87d7eee23a0ea1b468d4b1e282961a1
```

--------------------------------

### AppChat API: List User Chats

Source: https://movizor.ru/docs/ru/api-v2/appchat-api

Retrieves a list of chats for the current user. Supports filtering by account and optionally including chats from sub-users. No specific code examples are provided, but parameters indicate potential API calls.

--------------------------------

### POST /api_2/mycompany/object_add

Source: https://movizor.ru/docs/ru/api-v2/basic

Добавление нового объекта (абонента) для мониторинга. Используется при формировании заявки на перевозку.

```APIDOC
## POST /api_2/mycompany/object_add

### Description
Этот метод позволяет добавить новый объект (абонента) для мониторинга. Это может быть полезно при формировании заявки на перевозку в вашей учетной системе (1С/ERP/CRM).

### Method
POST

### Endpoint
`https://movizor.ru/api_2/mycompany/object_add/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **phone** (string) - Required - Номер телефона объекта в международном формате MSISDN.
- **title** (string) - Required - Название объекта.
- **tariff** (integer) - Required - Идентификатор тарифа.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "phone": "79991234567",
  "title": "Test Object",
  "tariff": 2
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса (например, "OK").
- **message** (string) - Сообщение о результате операции.

#### Response Example
```json
{
  "status": "OK",
  "message": "Object added successfully."
}
```
```

--------------------------------

### Movizor API (v2) - Основные принципы

Source: https://movizor.ru/docs/ru/api-v2/basic

Общее описание API Movizor (v2), его основные принципы, варианты использования и требования к запросам.

```APIDOC
## Movizor API (v2) - Основные принципы

### Description
Интегрируйте сервис мониторинга Movizor в свою систему для оперативного подключения и управления объектами, предоставления доступа к данным о местоположении клиентам, интеграции гибкого мониторинга как услуги и автоматизации процесса подключения.

### Протокол
RESTful HTTPS

### Формат данных
JSON

### Методы запросов
GET или POST

### Кодировка
UTF-8

### Базовый URL
`https://movizor.ru/api_2/`

### Обязательные параметры
- **project** (string) - Название вашего проекта.
- **key** (string) - Ключ доступа (токен).

### Пример запроса на добавление абонента
`https://movizor.ru/api_2/mycompany/object_add/?key=123&phone=79991234567&title=Test&tariff=2`

### Варианты использования API
1. **Подключение объектов**: При формировании заявки на перевозку отправляйте запрос на подключение абонента методом `object_add`.
2. **Отображение статуса**: Показывайте статус подключения объекта (из методов `object_get` или `object_list`) в заявке.
3. **Определение местоположения**: Используйте кнопку "Определить местоположение" с вызовом метода `pos_request` или автоматические тарифы.
4. **Отображение данных**: В заявке отображайте карту с местоположением или данные из аналитики (из метода `object_get`).
5. **Отключение объектов**: По окончании перевозки отключайте объект методом `object_delete`.

### Методы для выгрузки данных
- **object_list**: Список всех объектов и их статусы.
- **pos_objects**: Список всех объектов с последними координатами.
- **pos_last**: Последнее местоположение конкретного объекта.
- **pos_list**: Список местоположений в указанный диапазон времени по конкретному объекту.
- **events**: Список событий по всему аккаунту.

### Определение
**Объект**: Сотовый номер телефона в международном формате MSISDN, используемый для мониторинга. Система постарается привести переданный номер к международному формату.
**Запрос**: Запрос на определение местоположения абонента (методом `pos_request`). Является тарифицируемым.
```

--------------------------------

### Получение списка объектов и их статусов Movizor API

Source: https://movizor.ru/docs/ru/api-v2/basic

Метод object_list позволяет получить список всех объектов, зарегистрированных в системе, а также их текущие статусы. Используется для визуального контроля и отображения в учетной системе.

```http
https://movizor.ru/api_2/mycompany/object_list/?key=YOUR_KEY&project=YOUR_PROJECT
```

--------------------------------

### POST /api_2/mycompany/pos_request

Source: https://movizor.ru/docs/ru/api-v2/basic

Запрос на определение местоположения конкретного объекта. Требует дополнительной тарификации.

```APIDOC
## POST /api_2/mycompany/pos_request

### Description
Этот метод инициирует запрос на определение местоположения объекта. Обратите внимание, что этот запрос тарифицируется. Для получения координат после запроса используйте метод `pos_get`, указав `request_id`.

### Method
POST

### Endpoint
`https://movizor.ru/api_2/mycompany/pos_request/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **object_id** (integer) - Required - Идентификатор объекта, для которого нужно определить местоположение.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "object_id": 12345
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **request_id** (string) - Уникальный идентификатор запроса на определение местоположения.

#### Response Example
```json
{
  "status": "OK",
  "request_id": "req_abc123def456"
}
```
```

--------------------------------

### Удаление объекта из мониторинга Movizor API

Source: https://movizor.ru/docs/ru/api-v2/basic

Метод object_delete позволяет отключить мониторинг для указанного объекта. Используется по окончании перевозки или при необходимости прекратить отслеживание.

```http
https://movizor.ru/api_2/mycompany/object_delete/?key=YOUR_KEY&project=YOUR_PROJECT&object_id=OBJECT_ID
```

--------------------------------

### POST /api_2/mycompany/object_delete

Source: https://movizor.ru/docs/ru/api-v2/basic

Удаление объекта (абонента) из системы мониторинга. Используется по окончании перевозки.

```APIDOC
## POST /api_2/mycompany/object_delete

### Description
Этот метод позволяет удалить объект (абонента) из системы мониторинга. Рекомендуется использовать этот метод по окончании перевозки или когда мониторинг больше не требуется.

### Method
POST

### Endpoint
`https://movizor.ru/api_2/mycompany/object_delete/`

### Parameters
#### Query Parameters
- **key** (string) - Required - Ключ доступа (токен).
- **object_id** (integer) - Required - Идентификатор объекта для удаления.

### Request Example
```json
{
  "project": "mycompany",
  "key": "YOUR_API_KEY",
  "object_id": 12345
}
```

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса (например, "OK").
- **message** (string) - Сообщение о результате операции.

#### Response Example
```json
{
  "status": "OK",
  "message": "Object deleted successfully."
}
```
```

--------------------------------

### Получение последнего местоположения объекта Movizor API

Source: https://movizor.ru/docs/ru/api-v2/basic

Метод pos_last возвращает последние известные координаты конкретного объекта. Используется для периодического обновления данных о местоположении, особенно при использовании автоматических тарифов.

```http
https://movizor.ru/api_2/mycompany/pos_last/?key=YOUR_KEY&project=YOUR_PROJECT&object_id=OBJECT_ID
```

--------------------------------

### Пример запроса на добавление абонента Movizor API

Source: https://movizor.ru/docs/ru/api-v2/basic

Пример GET-запроса для добавления абонента в систему Movizor. Требует указания ключа доступа, номера телефона, названия объекта и тарифного плана. Формат ответа - JSON.

```http
https://movizor.ru/api_2/mycompany/object_add/?key=123&phone=79991234567&title=Test&tariff=2
```

--------------------------------

### OAuth 2.0 Authorization Flow

Source: https://movizor.ru/docs/ru/api-v2/auth

This snippet illustrates the initial step of the OAuth 2.0 flow, where a user is redirected to authorize an application. The `app_id` and `redirect_url` are required parameters. The subsequent `code` is used to obtain an access token.

```HTTP
https://movizor.ru/oauth/authorize/?app_id=1&redirect_url=http://localhost/
```

--------------------------------

### Запрос на определение местоположения объекта Movizor API

Source: https://movizor.ru/docs/ru/api-v2/basic

Метод pos_request инициирует запрос на определение текущего местоположения объекта. В ответе возвращается request_id, который используется для получения результатов методом pos_get. Этот метод тарифицируется.

```http
https://movizor.ru/api_2/mycompany/pos_request/?key=YOUR_KEY&project=YOUR_PROJECT&object_id=OBJECT_ID
```

--------------------------------

### Получение данных о запросе местоположения Movizor API

Source: https://movizor.ru/docs/ru/api-v2/basic

Метод pos_get используется для получения информации о ранее выполненном запросе на определение местоположения, включая полученные координаты. Требует указания request_id, полученного от метода pos_request.

```http
https://movizor.ru/api_2/mycompany/pos_get/?key=YOUR_KEY&project=YOUR_PROJECT&request_id=REQUEST_ID
```

--------------------------------

### OAuth 2.0 Authentication

Source: https://movizor.ru/docs/ru/api-v2/auth

Alternative authorization method for accessing a client's account via API. Recommended for integrating the service into third-party products, applications, or services.

```APIDOC
## OAuth 2.0 Authentication

### Description
Alternative authorization method for accessing a client's account via API. Recommended for integrating the service into third-party products, applications, or services. This flow involves obtaining an authorization code and exchanging it for an access token.

### Step 1: Authorize Application
Redirect the user to the authorization URL to grant your application access to their account.

#### Endpoint
`https://movizor.ru/oauth/authorize/?app_id={app_id}&redirect_url={redirect_url}`

#### Parameters
- **app_id** (integer) - Required - The unique identifier for your application.
- **redirect_url** (string) - Required - The URL to redirect the user to after authorization. This URL will receive the authorization code.

#### Example Redirect URL
`https://movizor.ru/oauth/authorize/?app_id=1&redirect_url=http://localhost/`

### Step 2: Obtain Authorization Code
After the user grants access, they will be redirected to your `redirect_url` with an authorization `code` in the query parameters.

#### Example Callback URL
`http://localhost/?code=77a04169132674e0`

### Step 3: Exchange Code for Token
Make a POST request to exchange the authorization code for an access token.

#### Endpoint
`https://movizor.ru/oauth/code/`

#### Method
POST

#### Parameters
- **code** (string) - Required - The authorization code received in the previous step.

#### Request Example
`https://movizor.ru/oauth/code/?code=77a04169132674e0`

#### Response Example (Success)
```json
{
  "code": "OK",
  "message": "Token created",
  "result": "success",
  "data": {
    "app_id": "1",
    "client_id": "70123",
    "token": "12bf14ce521713adb5bf2cc6416252eb87d7eee23a0ea1b468d4b1e282961a1"
  }
}
```

### Step 4: Use Access Token for API Requests
Include the obtained `token` in your API requests to act on behalf of the user.

#### Endpoint Example
`https://movizor.ru/api_2/app/object_add/?phone=79991112233&title=Test&tariff=4&token=12bf14ce521713adb5bf2cc6416252eb87d7eee23a0ea1b468d4b1e282961a1`

#### Parameters
- **token** (string) - Required - The user's access token.
- Other API parameters as required by the specific endpoint.
```

--------------------------------

### AppChat API - List Chats

Source: https://movizor.ru/docs/ru/api-v2/appchat-api

Retrieves a list of chats for the current user, with options to filter by account and include subuser chats.

```APIDOC
## GET /appchat/list

### Description
Retrieves a list of chats for the current user. You can filter chats by a specific account and choose to include chats from subusers.

### Method
GET

### Endpoint
/appchat/list

### Parameters
#### Query Parameters
- **account** (int) - Optional - The account number to filter chats by.
- **get_subusers** (int) - Optional - A flag (1 or 0) indicating whether to retrieve chats for subusers.
```

--------------------------------

### AppChat API - Send Message

Source: https://movizor.ru/docs/ru/api-v2/appchat-api

Sends a message to a specific chat identified by its unique chat key.

```APIDOC
## POST /appchat/post

### Description
Sends a message to a specific chat.

### Method
POST

### Endpoint
/appchat/post

### Parameters
#### Request Body
- **chat_key** (string) - Required - The unique key of the chat to send the message to.
- **text** (string) - Required - The content of the message to be sent.
```
Tokens:
Raw