> For the complete documentation index, see [llms.txt](https://wiki.holyworld.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.holyworld.me/lite/api/rest-api.md).

# REST API

Публичный REST API для разработчиков.

Доступен по адресу: `https://api.holyworld.me`

***

## Методы

## Получить историю обменов монет

> Возвращает список последних сделок обмена монет. При указании параметра limit возвращает не более указанного числа записей. Не требует авторизации.

```json
{"openapi":"3.0.3","info":{"title":"LiteAPI Service — Public","version":"1.0"},"security":[],"paths":{"/v1/coins-trades":{"get":{"tags":["CoinsTrade"],"summary":"Получить историю обменов монет","description":"Возвращает список последних сделок обмена монет. При указании параметра limit возвращает не более указанного числа записей. Не требует авторизации.","operationId":"getCoinsTrades","parameters":[{"name":"limit","in":"query","description":"Максимальное количество возвращаемых записей (целое число)","required":false,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Список сделок обмена монет","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CoinsTrade"}}}}},"400":{"description":"Неверный запрос"}},"deprecated":false}}},"components":{"schemas":{"CoinsTrade":{"type":"object","additionalProperties":false,"properties":{"rate":{"type":"number","format":"double"},"datetime":{"type":"integer","format":"int64"}},"required":["rate","datetime"]}}}}
```

## Получить список активных событий

> Возвращает активные события на серверах. При указании параметра server возвращает массив событий только для указанного сервера. Без параметра server возвращает объект, где ключ — идентификатор сервера, а значение — массив событий на нём (пустые списки исключаются). Не требует авторизации.

```json
{"openapi":"3.0.3","info":{"title":"LiteAPI Service — Public","version":"1.0"},"security":[],"paths":{"/v1/events":{"get":{"tags":["Events"],"summary":"Получить список активных событий","description":"Возвращает активные события на серверах. При указании параметра server возвращает массив событий только для указанного сервера. Без параметра server возвращает объект, где ключ — идентификатор сервера, а значение — массив событий на нём (пустые списки исключаются). Не требует авторизации.","operationId":"getEvents","parameters":[{"name":"server","in":"query","description":"Идентификатор сервера для фильтрации событий","required":false,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Массив событий (при указанном server) либо объект вида {server: события[]} (без server)","content":{"application/json":{"schema":{"type":"object"}}}}},"deprecated":false}}}}
```

## Проверка состояния сервиса

> Возвращает статус работоспособности сервиса. Не требует авторизации.

```json
{"openapi":"3.0.3","info":{"title":"LiteAPI Service — Public","version":"1.0"},"security":[],"paths":{"/v1/health":{"get":{"tags":["Health"],"summary":"Проверка состояния сервиса","description":"Возвращает статус работоспособности сервиса. Не требует авторизации.","operationId":"getHealth","parameters":[],"responses":{"200":{"description":"Сервис работает","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"deprecated":false}}},"components":{"schemas":{"HealthResponse":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string"}}}}}}
```

## Получить список серверов

> Возвращает список всех известных серверов с их отображаемыми именами. При указании параметра id возвращает данные конкретного сервера. Не требует авторизации.

```json
{"openapi":"3.0.3","info":{"title":"LiteAPI Service — Public","version":"1.0"},"security":[],"paths":{"/v1/servers":{"get":{"tags":["Servers"],"summary":"Получить список серверов","description":"Возвращает список всех известных серверов с их отображаемыми именами. При указании параметра id возвращает данные конкретного сервера. Не требует авторизации.","operationId":"getServers","parameters":[{"name":"id","in":"query","description":"Идентификатор сервера для получения информации об одном сервере","required":false,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Данные сервера или список всех серверов","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Сервер не найден","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":false}}},"components":{"schemas":{"ErrorResponse":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}}}}}}
```

## Получить список активных голосований

> Возвращает активные голосования с кандидатами и числом голосов. При указании параметра server возвращает массив голосований только для указанного сервера. Без параметра server возвращает объект, где ключ — идентификатор сервера, а значение — массив голосований на нём (пустые списки исключаются). Не требует авторизации.

```json
{"openapi":"3.0.3","info":{"title":"LiteAPI Service — Public","version":"1.0"},"security":[],"paths":{"/v1/votings":{"get":{"tags":["Votings"],"summary":"Получить список активных голосований","description":"Возвращает активные голосования с кандидатами и числом голосов. При указании параметра server возвращает массив голосований только для указанного сервера. Без параметра server возвращает объект, где ключ — идентификатор сервера, а значение — массив голосований на нём (пустые списки исключаются). Не требует авторизации.","operationId":"getVotings","parameters":[{"name":"server","in":"query","description":"Идентификатор сервера для фильтрации голосований","required":false,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Массив активных голосований","content":{"application/json":{"schema":{"type":"object"}}}}},"deprecated":false}}}}
```

***

## Rate limiting

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

Открытый API содержит только `GET`-запросы.

Анти-DDoS-защита может временно ограничить аномально интенсивный трафик.

***

## Правила доступа

Перечисленные методы доступны без авторизации.

Для доступа к другим возможностям сервера нужен **специальный токен**, который в данное время выдаётся в индивидуальном порядке при согласовании необходимых прав доступа.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wiki.holyworld.me/lite/api/rest-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.