Ресурсы · 107

Асинхронные задания API

Принятый запрос не доказывает завершение работы.

Обновлено · 2 min

Чего помогает достичь это руководство

  • Определить состояния и права
  • Возобновить наблюдение
  • Подтвердить исход

Быстрая проверка

  • Доказывает ли 202 будущее завершение?
  • Отмена удаляет уже возникшие эффекты?

Пошаговый метод

  1. 1

    Определить состояния и права

    Различайте принято, ожидает, выполняется, завершено, ошибка и отмена запрошена. HTTP 202 не гарантирует успех. Проверяйте права аккаунта на состояние, результат и отмену; идентификатор не заменяет разрешение.

    Аккаунт, операция и повторно используемый идентификатор

  2. 2

    Возобновить наблюдение

    Сохраните существующую ссылку. Определите интервал, длительность, срок хранения и действие при отсутствии состояния. При защите от дублей документируйте её границы и испытайте потерянный ответ перед повторением запроса.

    Состояние, время, интервал и срок

  3. 3

    Подтвердить исход

    Испытайте отмену при обработке и публикации, сбой исполнителя и просроченный результат. Проверьте оставшиеся эффекты и прекратите опрос при конечном состоянии.

    Результат, ошибка, отмена и оставшиеся эффекты

Многоразовый рабочий лист

Заполните ваши авторизованные наблюдения. Эти поля являются рабочим шаблоном, а не наблюдаемыми результатами.

ПолеИнформация для записи
СсылкаАккаунт, операция и повторно используемый идентификатор
НаблюдениеСостояние, время, интервал и срок
ИсходРезультат, ошибка, отмена и оставшиеся эффекты
ПриёмкаОдно разрешённое задание и проверенный исход после обрыва

Вымышленный пример

Иллюстративная ситуация

Вымышленный пример: ответ о принятии экспорта теряется и пользователь повторяет попытку.

Решение и ожидаемые доказательства

Испытание проверяет, возвращает ли контракт повторения существующее задание. Без такой гарантии запрос надо проверить до создания нового; интерфейс не доказывает уникальность.

Показатели управления

ПоказательЧто он измеряетПервое действие
Застрявшие заданияЗапросы без обновлений в установленный срокНазначить проверку, восстановление или закрытие
ПродолжениеВозобновлённое наблюдение без нового заданияРазбирать перезапуски и дубли

Распространенные ошибки

    Часто задаваемые вопросы

    Доказывает ли 202 будущее завершение?

    Нет. Он подтверждает принятие к обработке, а не конечный результат. Проверяйте состояние операции.

    Отмена удаляет уже возникшие эффекты?

    Не обязательно. Подтвердите конечное состояние и сверяйте существующие эффекты.

    Официальные ссылки

    Ссылки подтверждают метод. Адаптируйте проверки к вашему контексту; они не являются сертификацией. Оригинальные названия ссылок и исходные документы могут быть на другом языке.

    Источники проверены .