Partner API KKK

Mis vahe on konto API võtmel ja mudeli API võtmel?

Kontotaseme API võti (mg_partner_...) haldab mudeli API võtmeid https://p-api.model-gate.com/api/v1/partner/* ja hangib läbi asünkroonsed tulemused https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Mudeli API võti (mg_live_...) autentib järeldustaotlused läbi https://api.model-gate.com.

Ärge kunagi saatke kontotaseme Partner API võtit järelduse lõpp-punkti ega avaldage seda kliendipoolsetes rakendustes.

Milline loendur jõustab spend_limit?

Lähtestatav usage loendur jõustab piiri. POST /api/v1/partner/keys/{key_public_id}/reset-usage tühjendab võtmeloenduri. total_spent on eluaegne arvestus ja seda ei lähtesta kunagi.

Kas igal Model API võtmel on eraldi kontojääk?

Ei. Kõik Model API võtmed kulutavad Model Gate'i konto saldost. Võtme- ja rühmapiirangud piiravad kasutamist ilma kontojääki alamsaldodeks jagamata.

Mis juhtub, kui Model API võtit pööratakse?

Vana saladus lakkab koheselt töötamast. Pöörlemisvastus sisaldab uut lihttekstisaladust üks kord. Hoidke seda turvaliselt, sest Model Gate ei kuva uuesti täielikku saladust.

Kuidas on tagasihelistamised konfigureeritud?

Seadistage callback_url ja pöörake callback_secret Model Gate'i profiilis. Asünkroonse lõpetamise tulemused saadetakse tagasihelistamise URL-i olemasolul. Valikulised madala võtmelimiidi, võtmerühma limiidi ja madala kontojäägi sündmused saab eraldi lubada; nende läved on konfigureeritud profiili märguannetes.

Tagasihelistamine on vastupidav ja ei sõltu järelduste töötlemisest. Iga sündmus kannab endas talli event_id mis jääb korduskatsete jooksul muutumatuks ja seda tuleb kasutada tarbijate dubleerimiseks. Any HTTP 2xx vastus on edukas. Kohaletoimetamine kasutab kokku maksimaalselt 6 katset, korduskatsed 5 sekundi, 30 sekundi, 2 minuti, 10 minuti ja 1 tunni pärast; igal katsel on 15-sekundiline üldine aeg. Transpordivead, ajalõpud ja mitte-2xx vastused proovitakse uuesti ning pärast kuuendat ebaõnnestunud katset märgitakse sündmus failed ilma edasise automaatse uuesti proovimiseta. Vaata Tagasihelistamised sündmuste kataloogi jaoks täpsed kümnendkohad, allkirjad, sihtkoha turvalisus ja kohaletoimetamise üksikasjad.

Kui kaua saab asünkroonitud tulemust hankida?

Asünkroonne tulemus jääb kättesaadavaks 24 tunni jooksul GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Pärast aegumist salvestatud päring ja vastus kustutatakse ning lõpp-punkt naaseb 404.

Kas partneri mutatsioonid toetavad ohutut uuesti proovimist?

Jah. Iga Partner API POST, PATCHja DELETE nõuab Idempotency-Key. Proovige pärast ajalõpu sama loogilist toimingut sama võtmega uuesti; 7 päeva jooksul tagastab Model Gate algse tulemuse ilma mutatsiooni uuesti käivitamata. Võtme korduskasutamine teise päringu jaoks tagastab 409.

Kui kaua on üksikasjalik taotluste ajalugu saadaval?

Järgneb üksikasjalik partneritaotluste ajalugu API_REQUESTS_HOT_RETENTION_DAYS (vaikimisi 7 päeva) ja teatab selle akna vastuse metaandmetes. Pikemaajaliseks finantslevitamiseks kasutage kursori lehekülgedega kontosaldo tehinguid.