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 се отчита през целия живот и никога не се нулира.

Всеки ключ на API на модела има ли отделен баланс по сметката?

Не. Всички ключове за API на Model изразходват от баланса на притежавания акаунт в 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 дни) и отчита този прозорец в метаданни за отговор. Използвайте транзакции на салдо по сметката с пагинирани курсори за по-дългосрочно финансово съгласуване.