Partner API Pogosta vprašanja

Kakšna je razlika med ključem API računa in ključem API modela?

Ključ API na ravni računa (mg_partner_...) upravlja ključe API modela prek https://p-api.model-gate.com/api/v1/partner/* in pridobi asinhrone rezultate prek https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Ključ API modela (mg_live_...) preverja pristnost zahtev za sklepanje prek https://api.model-gate.com.

Nikoli ne pošljite ključa Partner API na ravni računa končni točki sklepanja ali ga razkrijte v aplikacijah na strani odjemalca.

Kateri števec uveljavlja spend_limit?

Ponastavljiv usage števec uveljavlja omejitev. POST /api/v1/partner/keys/{key_public_id}/reset-usage počisti števec ključev. total_spent je doživljenjsko računovodstvo in se nikoli ne ponastavi.

Ali ima vsak ključ modela API ločeno stanje na računu?

Ne. Vsi ključi Model API porabijo iz lastnega stanja na računu Model Gate. Omejitve po ključih in skupinah omejujejo uporabo brez razdelitve stanja računa na podrejena stanja.

Kaj se zgodi, ko se ključ API modela obrne?

Stara skrivnost takoj preneha delovati. Odziv vrtenja enkrat vsebuje novo skrivno besedilo. Varno ga shranite, ker Model Gate ne prikaže več celotne skrivnosti.

Kako so konfigurirani povratni klici?

Konfiguriraj callback_url in zavrtite callback_secret v profilu Model Gate. Rezultati asinhronega dokončanja se pošljejo, ko obstaja URL povratnega klica. Izbirne dogodke nizke meje ključa, omejitve ključne skupine in nizkega stanja na računu je mogoče omogočiti ločeno; njihove mejne vrednosti so konfigurirane v obvestilih o profilu.

Dostava povratnega klica je trajna in neodvisna od obdelave sklepanja. Vsak dogodek nosi hlev event_id ki ostane nespremenjen med ponovnimi poskusi in ga je treba uporabiti za deduplikacijo uporabnika. Kateri koli HTTP 2xx odziv uspešen. Dostava porabi največ 6 poskusov skupaj, s ponovnimi poskusi po 5 sekundah, 30 sekundah, 2 minutah, 10 minutah in 1 uri; vsak poskus ima 15-sekundno skupno časovno omejitev. Prenosne napake, časovne omejitve in odgovori, ki niso 2xx, se poskusijo znova, po šestem neuspelem poskusu pa se dogodek označi failed brez nadaljnjega samodejnega ponovnega poskusa. glej Povratni klici za katalog dogodkov, natančno decimalno koristno obremenitev, podpise, varnost ciljev in podrobnosti o dostavi.

Kako dolgo je mogoče pridobiti asinhroni rezultat?

Asinhroni rezultat ostane na voljo 24 ur GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Po poteku se shranjena zahteva in odgovor izbrišeta in končna točka se vrne 404.

Ali partnerske mutacije podpirajo varen ponovni poskus?

ja Vsak Partner API POST, PATCH, in DELETE zahteva Idempotency-Key. Znova poskusite isto logično operacijo z istim ključem po časovni omejitvi; 7 dni Model Gate vrne prvotni rezultat brez ponovne izvedbe mutacije. Ponovna uporaba ključa za drugo zahtevo vrne 409.

Kako dolgo je na voljo podrobna zgodovina zahtev?

Sledi podrobna zgodovina zahtev za partnerje API_REQUESTS_HOT_RETENTION_DAYS (privzeto 7 dni) in poroča to okno v metapodatkih odgovora. Za dolgoročnejšo finančno uskladitev uporabite transakcije stanja na računu, označene s kazalcem.