Partner API Vanlige spørsmål

Hva er forskjellen mellom en konto-API-nøkkel og en Model API-nøkkel?

API-nøkkelen på kontonivå (mg_partner_...) administrerer Model API-nøkler gjennom https://p-api.model-gate.com/api/v1/partner/* og henter asynkrone resultater gjennom https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

En modell API-nøkkel (mg_live_...) autentiserer slutningsforespørsler gjennom https://api.model-gate.com.

Send aldri en Partner API-nøkkel på kontonivå til et slutningspunkt eller eksponer den i applikasjoner på klientsiden.

Hvilken mot håndhever spend_limit?

Den tilbakestillelige usage counter håndhever grensen. POST /api/v1/partner/keys/{key_public_id}/reset-usage sletter nøkkeltelleren. total_spent er livstidsregnskap og tilbakestilles aldri.

Har hver Model API-nøkkel en separat kontosaldo?

Nei. Alle Model API-nøkler bruker fra den eierende Model Gate-kontosaldoen. Per-nøkkel- og gruppegrenser begrenser bruken uten å dele opp kontosaldoen i underordnede saldoer.

Hva skjer når en modell API-nøkkel roteres?

Den gamle hemmeligheten slutter å virke umiddelbart. Rotasjonssvaret inneholder den nye klarteksthemmeligheten én gang. Oppbevar den sikkert fordi Model Gate ikke viser hele hemmeligheten igjen.

Hvordan konfigureres tilbakeringinger?

Konfigurer callback_url og roter callback_secret i Model Gate-profilen. Asynkrone fullføringsresultater sendes når det finnes en tilbakeringings-URL. Valgfri lav nøkkelgrense, nøkkelgruppegrense og lav kontosaldo hendelser kan aktiveres separat; deres terskler er konfigurert i profilvarsler.

Tilbakeringingslevering er holdbar og uavhengig av slutningsbehandling. Hvert arrangement har en stall event_id som forblir uendret på tvers av forsøk og må brukes til forbrukerdeduplisering. Enhver HTTP 2xx svar er vellykket. Levering bruker maksimalt 6 forsøk totalt, med gjenforsøk etter 5 sekunder, 30 sekunder, 2 minutter, 10 minutter og 1 time; hvert forsøk har en total timeout på 15 sekunder. Transportfeil, tidsavbrudd og ikke-2xx-svar prøves på nytt, og etter det sjette mislykkede forsøket merkes hendelsen failed uten flere automatiske forsøk. Se Tilbakeringinger for hendelseskatalogen, nyttelaster med nøyaktig desimal, signaturer, destinasjonssikkerhet og leveringsdetaljer.

Hvor lenge kan et asynkronisert resultat hentes?

Et asynkront resultat forblir tilgjengelig i 24 timer GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Etter utløp slettes den lagrede forespørselen og svaret og endepunktet returnerer 404.

Støtter partnermutasjoner trygt gjenforsøk?

Ja. Hver Partner API POST, PATCH, og DELETE krever Idempotency-Key. Prøv den samme logiske operasjonen på nytt med samme nøkkel etter et tidsavbrudd; i 7 dager returnerer Model Gate det opprinnelige resultatet uten å utføre mutasjonen på nytt. Gjenbruk av en nøkkel for en annen forespørsel returnerer 409.

Hvor lenge er detaljert forespørselshistorikk tilgjengelig?

Detaljert partnerforespørselshistorikk følger API_REQUESTS_HOT_RETENTION_DAYS (standard 7 dager) og rapporterer det vinduet i responsmetadata. Bruk markørpaginerte kontosaldotransaksjoner for langsiktig økonomisk avstemming.