# Матриця повторів і завершення для Shared Resources

Політика повторів, ідемпотентності та завершення для 26 операцій Shared Resources. З них 12 документують бізнес-коди помилок, специфічні для ендпоінта.

> Для операцій, що змінюють стан, тайм-аут HTTP означає невідомий результат, а не доказ невдачі. Перед повтором запитайте поточний стан.


Визначення політик та інші продукти див. у [Матриці повторів ендпоінтів](/uk/api-reference/getting-started/endpoint-behavior), машинно-читну версію — у [Маніфесті поведінки операцій](/assets/operation-behavior.8a452a27fdb2398e4085aaff39b0d6f29825844e56ccba51c7fceb4bcf57c29c.ec0bf2e0.yaml).

## Shared Resources Local API

| Операція | Політика повторів | Ідемпотентність | Завершення / відновлення |
|  --- | --- | --- | --- |
| `POST /api/proxyInfo/page``queryProxyInfoPageUsingPOST` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/proxyInfo/add``addUsingPOST` | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `14023`. |
| `POST /api/proxyInfo/update``updateProxyUsingPOST` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `14003`, `14023`. |
| `POST /api/proxyInfo/delete``deleteProxyUsingPOST` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `14017`, `14024`. |
| `POST /api/envgroup/page``apiEnvgroupPagePost` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/envgroup/edit``apiEnvgroupEditPost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/envgroup/create``apiEnvgroupCreatePost` | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/envgroup/delete``apiEnvgroupDeletePost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `19064`. |
| `GET /api/envtag/all``apiEnvtagAllGet` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/envtag/create``apiEnvtagCreatePost` | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/envtag/edit``apiEnvtagEditPost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /api/envtag/delete``apiEnvtagDeletePost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `19105`. |
| `POST /api/webhook/config``apiWebhookConfigPost` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Upsert за командою; повторення того самого запиту сходиться до тієї самої збереженої конфігурації. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `41001`. |


## Shared Resources Open API

| Операція | Політика повторів | Ідемпотентність | Завершення / відновлення |
|  --- | --- | --- | --- |
| `POST /proxyInfo/page``queryProxyInfoPageUsingPOST` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /proxyInfo/add``addUsingPOST` | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `14023`. |
| `POST /proxyInfo/update``updateProxyUsingPOST` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `14003`, `14023`. |
| `POST /proxyInfo/delete``deleteProxyUsingPOST` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `14017`, `14024`. |
| `POST /envgroup/page``envgroupPagePost` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /envgroup/edit``envgroupEditPost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /envgroup/create``envgroupCreatePost` | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /envgroup/delete``envgroupDeletePost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `19064`. |
| `GET /envtag/all``envtagAllGet` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /envtag/create``envtagCreatePost` | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /envtag/edit``envtagEditPost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| `POST /envtag/delete``envtagDeletePost` | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `19105`. |
| `POST /webhook/config``webhookConfigPost` | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Upsert за командою; повторення того самого запиту сходиться до тієї самої збереженої конфігурації. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: `41001`. |