Partner API GYIK

Mi a különbség a fiók API-kulcs és a Model API-kulcs között?

A fiókszintű API-kulcs (mg_partner_...) keresztül kezeli a Model API kulcsait https://p-api.model-gate.com/api/v1/partner/* és ezen keresztül lekéri az aszinkron eredményeket https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Egy modell API kulcs (mg_live_...) keresztül hitelesíti a következtetési kéréseket https://api.model-gate.com.

Soha ne küldjön fiókszintű Partner API kulcsot egy következtetési végponthoz, és ne tegye közzé azt ügyféloldali alkalmazásokban.

Amelyik számláló érvényesít spend_limit?

A visszaállítható usage számláló érvényesíti a határt. POST /api/v1/partner/keys/{key_public_id}/reset-usage törli a kulcsszámlálót. total_spent élettartamra szóló elszámolás, és soha nem alaphelyzetbe áll.

Minden Model API-kulcsnak külön számlaegyenlege van?

Nem. Minden Model API-kulcs a tulajdonos Model Gate számlaegyenlegéből költ. A kulcsonkénti és csoportos korlátok korlátozzák a használatot anélkül, hogy a számlaegyenleget felosztanák gyermekegyenlegekre.

Mi történik egy Model API kulcs elforgatásakor?

A régi titok azonnal leáll. A forgatási válasz egyszer tartalmazza az új nyílt szöveges titkot. Tárolja biztonságosan, mert a Model Gate nem jeleníti meg újra a teljes titkot.

Hogyan vannak konfigurálva a visszahívások?

Konfigurálás callback_url és forgasd callback_secret a Model Gate profilban. Az aszinkron befejezési eredményeket a rendszer elküldi, ha létezik visszahívási URL. Az opcionális alacsony kulcslimit, kulcscsoport limit és alacsony számlaegyenleg események külön engedélyezhetők; a küszöbértékek a Profilértesítésekben vannak beállítva.

A visszahívási kézbesítés tartós és független a következtetésfeldolgozástól. Minden eseménynek van istállója event_id amely változatlan marad az újrapróbálkozások során, és a fogyasztói duplikációhoz kell használni. Bármilyen HTTP 2xx a válasz sikeres. A kézbesítés összesen legfeljebb 6 kísérletet vesz igénybe, az újrapróbálkozások 5 másodperc, 30 másodperc, 2 perc, 10 perc és 1 óra múlva; minden kísérlethez 15 másodperces teljes időtúllépés tartozik. A szállítási hibák, az időtúllépések és a nem 2xx válaszok újrapróbálódnak, és a hatodik sikertelen kísérlet után az esemény megjelölésre kerül failed további automatikus újrapróbálkozás nélkül. Lásd Visszahívások az eseménykatalógushoz, pontos tizedesjegyű rakományok, aláírások, a célállomás biztonsága és a kézbesítés részletei.

Mennyi ideig lehet lekérni egy aszinkron eredményt?

Az aszinkron eredmény 24 órán keresztül elérhető marad GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. A lejárat után a tárolt kérés és válasz törlődik, és a végpont visszatér 404.

A partnermutációk támogatják a biztonságos újrapróbálást?

Igen. Minden Partner API POST, PATCH, és DELETE megköveteli Idempotency-Key. Próbálja újra ugyanazt a logikai műveletet ugyanazzal a kulccsal egy időtúllépés után; 7 napig a Model Gate visszaadja az eredeti eredményt anélkül, hogy újra végrehajtaná a mutációt. A kulcs újbóli felhasználása egy másik kérelemhez visszatér 409.

Meddig érhető el részletes kéréstörténet?

Részletes Partner-igénylési előzmények következnek API_REQUESTS_HOT_RETENTION_DAYS (alapértelmezett 7 nap), és ezt az ablakot jelenti a válasz metaadatai között. Hosszabb távú pénzügyi egyeztetéshez használja a kurzorral lapozott számlaegyenleg-tranzakciókat.