Partner API Nejčastější dotazy

Jaký je rozdíl mezi klíčem API účtu a klíčem API modelu?

Klíč API na úrovni účtu (mg_partner_...) spravuje klíče API modelu prostřednictvím https://p-api.model-gate.com/api/v1/partner/* a načítá asynchronní výsledky prostřednictvím https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Klíč API modelu (mg_live_...) ověřuje požadavky na odvození prostřednictvím https://api.model-gate.com.

Nikdy neposílejte klíč Partner API na úrovni účtu do odvozeného koncového bodu ani jej nevystavujte v aplikacích na straně klienta.

Které počítadlo vynucuje spend_limit?

Resetovatelný usage čítač vynucuje limit. POST /api/v1/partner/keys/{key_public_id}/reset-usage vymaže počítadlo klíče. total_spent je celoživotní účtování a nikdy se neresetuje.

Má každý model API klíč samostatný zůstatek na účtu?

Ne. Všechny klíče API modelu utratí ze zůstatku na účtu Model Gate. Limity na klíč a skupiny omezují použití bez rozdělení zůstatku na účtu na podřízené zůstatky.

Co se stane, když se otočí klíč API modelu?

Staré tajemství okamžitě přestane fungovat. Odpověď na otočení jednou obsahuje nový tajný klíč ve formátu prostého textu. Uložte jej bezpečně, protože Model Gate znovu nezobrazuje úplné tajemství.

Jak se konfigurují zpětná volání?

Konfigurovat callback_url a otočit callback_secret v profilu Model Gate. Výsledky asynchronního dokončení jsou odeslány, když existuje adresa URL pro zpětné volání. Volitelné události nízkého klíče, omezení skupiny klíčů a události nízkého zůstatku účtu lze aktivovat samostatně; jejich prahové hodnoty se konfigurují v oznámeních profilu.

Doručování zpětného volání je trvalé a nezávislé na zpracování odvození. Každá akce nese stáj event_id který zůstává během opakování nezměněn a musí být použit pro deduplikaci spotřebitelů. Jakýkoli HTTP 2xx odpověď je úspěšná. Doručení využívá maximálně 6 pokusů celkem, s opakováním po 5 sekundách, 30 sekundách, 2 minutách, 10 minutách a 1 hodině; každý pokus má celkový časový limit 15 sekund. Chyby přenosu, časové limity a odpovědi jiné než 2xx se opakují a po šestém neúspěšném pokusu je událost označena failed bez dalšího automatického opakování. Vidět Zpětná volání pro katalog událostí, přesná desetinná data, podpisy, zabezpečení místa určení a podrobnosti o doručení.

Jak dlouho lze načíst asynchronní výsledek?

Asynchronní výsledek zůstává k dispozici po dobu 24 hodin GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Po vypršení platnosti se uložený požadavek a odpověď odstraní a vrátí se koncový bod 404.

Podporují partnerské mutace bezpečné opakování?

Ano. Každých Partner API POST, PATCHa DELETE vyžaduje Idempotency-Key. Po uplynutí časového limitu opakujte stejnou logickou operaci se stejným klíčem; po dobu 7 dnů Model Gate vrátí původní výsledek bez opětovného provedení mutace. Opětovné použití klíče pro jiný požadavek se vrátí 409.

Jak dlouho je k dispozici podrobná historie požadavků?

Následuje podrobná historie požadavků partnera API_REQUESTS_HOT_RETENTION_DAYS (výchozí 7 dní) a hlásí toto okno v metadatech odpovědi. Použijte kurzorem stránkované transakce zůstatku účtu pro dlouhodobější finanční odsouhlasení.