Політика повторів, ідемпотентності та завершення для 26 операцій Shared Resources. З них 12 документують бізнес-коди помилок, специфічні для ендпоінта.
Для операцій, що змінюють стан, тайм-аут HTTP означає невідомий результат, а не доказ невдачі. Перед повтором запитайте поточний стан.
Визначення політик та інші продукти див. у Матриці повторів ендпоінтів, машинно-читну версію — у Маніфесті поведінки операцій.
| Операція | Політика повторів | Ідемпотентність | Завершення / відновлення |
|---|---|---|---|
POST /api/proxyInfo/pagequeryProxyInfoPageUsingPOST | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/proxyInfo/addaddUsingPOST | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 14023. |
POST /api/proxyInfo/updateupdateProxyUsingPOST | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 14003, 14023. |
POST /api/proxyInfo/deletedeleteProxyUsingPOST | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 14017, 14024. |
POST /api/envgroup/pageapiEnvgroupPagePost | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/envgroup/editapiEnvgroupEditPost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/envgroup/createapiEnvgroupCreatePost | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/envgroup/deleteapiEnvgroupDeletePost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 19064. |
GET /api/envtag/allapiEnvtagAllGet | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/envtag/createapiEnvtagCreatePost | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/envtag/editapiEnvtagEditPost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/envtag/deleteapiEnvtagDeletePost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 19105. |
POST /api/webhook/configapiWebhookConfigPost | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Upsert за командою; повторення того самого запиту сходиться до тієї самої збереженої конфігурації. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 41001. |
| Операція | Політика повторів | Ідемпотентність | Завершення / відновлення |
|---|---|---|---|
POST /proxyInfo/pagequeryProxyInfoPageUsingPOST | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /proxyInfo/addaddUsingPOST | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 14023. |
POST /proxyInfo/updateupdateProxyUsingPOST | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 14003, 14023. |
POST /proxyInfo/deletedeleteProxyUsingPOST | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 14017, 14024. |
POST /envgroup/pageenvgroupPagePost | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /envgroup/editenvgroupEditPost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /envgroup/createenvgroupCreatePost | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /envgroup/deleteenvgroupDeletePost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 19064. |
GET /envtag/allenvtagAllGet | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /envtag/createenvtagCreatePost | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /envtag/editenvtagEditPost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /envtag/deleteenvtagDeletePost | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 19105. |
POST /webhook/configwebhookConfigPost | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Upsert за командою; повторення того самого запиту сходиться до тієї самої збереженої конфігурації. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 41001. |