AAtlas Developer Hub · API и интеграции
ДокументацияChangelog › Registry v2.2
Релиз

Registry API v2.2: bulk-операции, фильтр по тегам

Опубликовано 31.08.2026 · Версия v2.2 · Обратная совместимость сохранена

Обновление Registry API добавляет пакетные операции над устройствами и заявками. Раньше массовое обновление инвентаря требовало одного запроса на объект, что упиралось в лимит 200 RPS на токен.

Новое

curl -X POST https://api.—/v2/registry/devices/bulk \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"op":"patch","items":[{"id":"dev_8812","tags":["byod","msk"]}]}'

На что обратить внимание

  1. Пакетный запрос всегда возвращает 207 Multi-Status — проверяйте статус каждого элемента, а не код ответа.
  2. Частичный отказ не откатывает успешные элементы; повторный вызов идемпотентен по Idempotency-Key.
  3. Bulk-запросы учитываются в квоте как 10 обычных.
Клиентские SDK версии 3.2 уже содержат методы devices.bulk_patch() и requests.bulk_patch(). Отдельного обновления схемы OpenAPI не требуется — она подтягивается автоматически.