B2BB2B LLM

Partner API Честа питања

Практични одговори о кључевима налога, употреби, ротацији и повратним позивима.

Partner API Честа питања

Која је разлика између кључа АПИ налога и кључа АПИ модела?

АПИ кључ на нивоу налога (mg_partner_...) управља моделским АПИ кључевима преко https://p-api.model-gate.com/api/v1/partner/* и преузима асинхроне резултате кроз https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

АПИ кључ модела (mg_live_...) проверава аутентичност захтева за закључивање кроз https://api.model-gate.com.

Никада немојте слати кључ на нивоу налога Partner API на крајњу тачку закључивања нити га излагати у апликацијама на страни клијента.

Који контратер форс spend_limit?

Тхе ресетабле usage бројач спроводи ограничење. POST /api/v1/partner/keys/{key_public_id}/reset-usage брише бројач кључа. total_spent је доживотно рачуноводство и никада се не ресетује.

Да ли сваки модел АПИ кључ има засебно стање на рачуну?

Не. Сви Модел АПИ кључеви троше из стања на рачуну који поседује Модел Гате. Ограничења по кључу и групи ограничавају употребу без поделе стања на рачуну на подређена стања.

Шта се дешава када се ротира кључ АПИ модела?

Стара тајна одмах престаје да функционише. Одговор ротације садржи нову тајну отвореног текста једном. Чувајте га безбедно јер Модел капија не приказује поново потпуну тајну.

Како се конфигуришу повратни позиви?

Конфигуришите callback_url и ротирати callback_secret у профилу Модел капије. Резултати асинхроног завршетка се шаљу када постоји УРЛ за повратни позив. Опциони догађаји са ниским ограничењем, ограничењем групе кључева и ниским стањем на рачуну могу се омогућити одвојено; њихови прагови су конфигурисани у обавештењима профила.

Достава повратног позива је трајна и независна од обраде закључивања. Сваки догађај носи шталу event_id која остаје непромењена током поновних покушаја и мора се користити за дедупликацију потрошача. Било који ХТТП 2xx одговор је успешан. Испорука користи укупно највише 6 покушаја, са поновним покушајима након 5 секунди, 30 секунди, 2 минута, 10 минута и 1 сат; сваки покушај има укупно временско ограничење од 15 секунди. Поново се покушавају грешке у транспорту, временска ограничења и одговори који нису 2кк, а након шестог неуспелог покушаја догађај је означен failed без даљег аутоматског поновног покушаја. Види Повратни позиви за каталог догађаја, тачно децимални унос, потписе, безбедност одредишта и детаље испоруке.

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

Асинхрони резултат остаје доступан 24 сата GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Након истека, сачувани захтев и одговор се бришу и крајња тачка се враћа 404.

Да ли мутације партнера подржавају сигуран поновни покушај?

Да. Сваки Partner API POST, PATCH, и DELETE захтева Idempotency-Key. Покушајте поново са истом логичком операцијом са истим кључем након истека времена; током 7 дана Модел Гате враћа оригинални резултат без поновног извршавања мутације. Поновна употреба кључа за други захтев се враћа 409.

Колико дуго је доступна детаљна историја захтева?

Детаљна историја захтева партнера следи API_REQUESTS_HOT_RETENTION_DAYS (подразумевано 7 дана) и пријављује тај прозор у метаподацима одговора. Користите трансакције стања рачуна са курсором на страници за дугорочно финансијско помирење.