# API Presence

Presence — сервис, позволяющий работать со статусом онлайновости пользователей.

## Возможности Presence

- Получение статуса одного или нескольких пользователей

## Описание методов

<a id="get-presence-state-{code_id}-"></a>

Получение статуса пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/presence/state/123.0/' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/presence.openapi.json)

**Пример ответа (200)**

```json
{
  "code_id": "123.0",
  "state": "offline"
}
```

**Описание полей ответа**
- `code_id` — id пользователя
- `state` — состояние пользователя


Метод возвращает статус онлайновости пользователя по его AtiCode.ContactID.

<a id="post-presence-state"></a>

Возвращает статус для списка пользователей

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/presence/state' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '[
  "123456.0"
]'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/presence.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "code_id": "123.0",
    "state": "offline"
  }
]
```

**Описание полей ответа**
- `[].code_id` — id пользователя
- `[].state` — состояние пользователя


Метод возвращает список пользователей с их статусом онлайновости по их AtiCode.ContactID.
Можно получить статус не более сотни контактов за раз.
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).