Решения при управлении ресурсами

Какой ключ нужен сервису?

Для запросов к модели используйте ключ Model API, для управления ресурсами — Partner API. Приложение может хранить оба, но в разных записях хранилища секретов и отправлять каждый только на предназначенный ему адрес. В Business доступ Partner API — полномочие владельца компании, не разработчика проекта.

Перемещаются ли деньги вместе с ключом?

Нет. Ключи и проекты задают контекст бюджета и маршрутизации; источником списания остаётся кошелёк компании. Перемещение ключа не создаёт отдельный кошелёк, не переносит баланс и не переписывает историческое использование.

Почему использование отличается от расходов за всё время?

usage можно сбросить; оно может оцениваться по справочным ценам с дополнительным коэффициентом. total_spent фиксирует фактические исторические списания. Очищайте usage только для намеренного начала нового бюджетного интервала; это не возврат средств.

Изменение завершилось тайм-аутом. Создать новое?

Повторите то же логическое изменение с исходным ключом идемпотентности и неизменным телом. Новый ключ означает новую операцию и может продублировать эффект. Срок хранения идемпотентности — семь дней; сохраняйте собственную устойчивую связь операции и ключа.

Где результат завершения?

Для нативного асинхронного запроса получите его по публичному ID из /api/v1/requests/REQUEST_PUBLIC_ID с токеном Partner API соответствующего владельца. Результаты хранятся 24 часа. Подписанные callbacks дают способ доставки, но приложение всё равно должно устранять дубликаты и выполнять сверку.

Как сверять историю?

Используйте историю запросов для недавних подробностей по ключам и неизменных снимков цены. Следуйте указанному сроку хранения. Транзакции баланса предоставляют долговременный журнал кошелька; минутные списания API — не отдельная транзакция каждого запроса. Не восстанавливайте старую финансовую историю по текущему каталогу моделей.

Как общие ключи проекта влияют на сотрудников?

Playground авторизует сотрудника, вошедшего сейчас, даже если выбранный ключ проекта создал другой человек. Это краткосрочная делегация браузеру, не раскрытие многоразового токена владельца. Для серверных интеграций по-прежнему нужны намеренно назначенные долгоживущие ключи.

Отдельные результаты Images

Полномочия владельца компании по управлению через Partner API не раскрывают автоматически файлы Images сотрудника. Выделенные операции изображений читаются на хосте Model API с исходным разрешённым исполнителем/ключом проекта и текущей областью группы, не через эндпоинт результата нативного async в Partner API.