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

В чем разница между ключом API учетной записи и ключом API модели?

Ключ API уровня учетной записи (mg_partner_...) управляет ключами API модели через https://p-api.model-gate.com/api/v1/partner/* и получает асинхронные результаты через https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Ключ API модели (mg_live_...) аутентифицирует запросы вывода через https://api.model-gate.com.

Никогда не отправляйте ключ Partner API уровня учетной записи в конечную точку вывода и не раскрывайте его в клиентских приложениях.

Какой счетчик обеспечивает соблюдение spend_limit?

Сбрасываемый usage счетчик обеспечивает соблюдение лимита. POST /api/v1/partner/keys/{key_public_id}/reset-usage очищает счетчик ключей. total_spent ведется пожизненный учет и никогда не сбрасывается.

Имеет ли каждый ключ Model API отдельный баланс аккаунта?

Нет. Все ключи API модели расходуются с баланса учетной записи владельца Model Gate. Ограничения на ключ и группу ограничивают использование без разделения баланса учетной записи на дочерние балансы.

Что происходит при ротации ключа API модели?

Старый секрет тут же перестает действовать. Ответ на ротацию один раз содержит новый секрет открытого текста. Храните его в надежном месте, поскольку Model Gate больше не отобразит полный секрет.

Как настраиваются обратные вызовы?

Настроить callback_url и вращать callback_secret в профиле Model Gate. Результаты асинхронного завершения отправляются при наличии URL-адреса обратного вызова. Дополнительные события «нижнего лимита», «лимита группы ключей» и «низкого баланса счета» можно включить отдельно; их пороговые значения настраиваются в уведомлениях профиля.

Доставка обратного вызова является надежной и независимой от обработки вывода. Каждое событие несет в себе стабильный event_id он остается неизменным при повторных попытках и должен использоваться для дедупликации потребителей. Любой HTTP 2xx ответ успешен. Для доставки используется не более 6 попыток с повторными попытками через 5 секунд, 30 секунд, 2 минуты, 10 минут и 1 час; общий тайм-аут каждой попытки составляет 15 секунд. Ошибки транспорта, тайм-ауты и ответы, отличные от 2xx, повторяются, и после шестой неудачной попытки событие помечается. failed без дальнейшего автоматического повтора. Видеть Обратные вызовы для каталога событий, точные десятичные полезные данные, подписи, безопасность назначения и сведения о доставке.

Как долго можно получить асинхронный результат?

Асинхронный результат остается доступным в течение 24 часов. GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. По истечении срока действия сохраненный запрос и ответ удаляются, а конечная точка возвращается. 404.

Поддерживают ли мутации партнера безопасную повторную попытку?

Да. Каждый Partner API POST, PATCH, и DELETE требует Idempotency-Key. Повторите ту же логическую операцию с тем же ключом после таймаута; в течение 7 дней Model Gate возвращает исходный результат без повторного выполнения мутации. Повторное использование ключа для другого запроса возвращает результат 409.

Как долго доступна подробная история запросов?

Подробная история запросов партнеров приведена ниже. API_REQUESTS_HOT_RETENTION_DAYS (по умолчанию 7 дней) и сообщает об этом окне в метаданных ответа. Используйте транзакции баланса счета с разбивкой по страницам для более долгосрочной финансовой сверки.