> For the complete documentation index, see [llms.txt](https://help.rezonuniversal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rezonuniversal.com/metody-api/obshaya-informaciya.md).

# Формат запитів

Для запитів ("Клієнт - Сервер") використовуються HTTP GET або HTTP POST (рекомендуется) запити. Відповіді ("Сервер - Клиент") приходять в вигляді XML або JSON.

### Структура запиту

Запити направляються на адресу проекту, наприклад, <https://domain.rezonuniversal.com/api/> з **дозволених IP адрес**.

Дозволені IP потрібно додавати в Бекофісі в розділі Сайт-Налаштування -API

<figure><img src="https://827122301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGVHTd4I_c9f2PfJ3fE%2Fuploads%2FlTXxZ6qNqbxS1C0zxYNi%2F2026-07-13_09h32_37.png?alt=media&amp;token=37f96f01-b490-474f-b420-0af26feff6be" alt=""><figcaption></figcaption></figure>

Параметри можна надсилати методом GET, також і методом POST. Список параметрів, які мають бути в кожному запиті:

| key   | Ключ доступу         | \*\*\*\*\*                                                       |
| ----- | -------------------- | ---------------------------------------------------------------- |
| token | Токен доступу        | \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* |
| t     | Тип відповіді\*      | xml / json                                                       |
| lang  | Мова відповіді       | en / ru / ua                                                     |
| ip    | IP відвідувача сайту |                                                                  |

\*Тип відповіді також можна задати у змінній заголовку запиту Accept: `application/json` или `application/xml` відповідно.

### Структура відповіді

Будь-яка відповідь містить "оболонку", яка визначає статус відповіді, та кількість даних.

{% tabs %}
{% tab title="XML/HTML/SVG" %}

```markup
<?xml version="1.0" encoding="utf-16"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <StatusCode>200</StatusCode>
    <Status>OK</Status>
    <Body>
        <RequestID>422ecf71-2b7a-4db1-8046-5abe89919041</RequestID>
        <Data></Data>
        <TotalCount>0</TotalCount>
    </Body>
</Response>
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
{
   "StatusCode": "200",
   "Status": "OK",
   "Body": {
      "RequestID": "422ecf71-2b7a-4db1-8046-5abe89919041",
      "Data": [],
      "TotalCount": "0"
   }
}
```

{% endtab %}
{% endtabs %}

Опис полів відповіді

| StatusCode      | Статус відповіді            | 200 - Успішно, 400 - Невірний запит, 401 - Не авторизовано, 500 - Помилка сервера |
| --------------- | --------------------------- | --------------------------------------------------------------------------------- |
| Status          | Статус в текстовому вигляді |                                                                                   |
| Body/RequestID  | Унікальный UID запиту       |                                                                                   |
| Body/Data       | Основні дані                |                                                                                   |
| Body/TotalCount | Кількість даних             |                                                                                   |

### Обмеження RPS

На сьогодні всі методи API мають обмеження на 2 RPS (requests per second).\
Тобто. за 1 хвилину Ви можете виконати не більше ніж 120 запитів.\
При перевищенні цієї кількості запитів система поверне помилку `9003 RPS limit violetes`
