У каждой из 212 задокументированных операций есть политика повторов, идемпотентности и завершения. Политики выводятся из контракта OpenAPI консервативно. Бизнес-коды ошибок, специфичные для эндпоинта, перечисляются только там, где они задокументированы в описании операции, и никогда не придумываются. К любой операции дополнительно применяется общий контракт ошибок.
Для операций, меняющих состояние, тайм-аут HTTP означает неизвестный результат, а не доказательство неудачи. Прежде чем повторять, запросите текущее состояние.
Машиночитаемый источник — Манифест поведения операций.
| Продукт | Операций | С кодами, специфичными для эндпоинта | Матрица |
|---|---|---|---|
| Browser | 53 | 19 | Browser |
| Cloud Phone | 109 | 50 | Cloud Phone |
| Cloud Storage | 24 | 12 | Cloud Storage |
| Shared Resources | 26 | 12 | Shared Resources |
| Политика | Смысл |
|---|---|
| Безопасно с ограниченной экспоненциальной задержкой и дрожанием. | Операция только для чтения. Её повторение не меняет состояние ресурса. |
| После тайм-аута или сбоя передачи запросите текущее состояние перед повтором. | Операция могла уже примениться. Прочитайте ресурс перед повторной отправкой. |
| Не повторяйте автоматически; сначала выясните, был ли создан ресурс, загрузка или задача. | Операция что-то создаёт и не имеет ключа идемпотентности, поэтому слепой повтор может продублировать результат. |
| Не повторяйте автоматически, если документация эндпоинта не говорит, что это безопасно. | Контракт не даёт достаточно данных для классификации. Считайте операцию небезопасной. |
Покрытие генерации: 212 операций; 93 имеют задокументированные бизнес-коды, специфичные для эндпоинта, а 119 сейчас опираются на общий контракт ошибок.