Partner API ofte stillede spørgsmål

Hvad er forskellen mellem en konto-API-nøgle og en Model API-nøgle?

API-nøglen på kontoniveau (mg_partner_...) administrerer Model API-nøgler igennem https://p-api.model-gate.com/api/v1/partner/* og henter asynkrone resultater igennem https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

En model API-nøgle (mg_live_...) autentificerer slutningsanmodninger igennem https://api.model-gate.com.

Send aldrig en Partner API-nøgle på kontoniveau til et slutpunkt for slutninger, eller eksponer den aldrig i applikationer på klientsiden.

Hvilken kontra håndhæver spend_limit?

Den nulstillelige usage counter håndhæver grænsen. POST /api/v1/partner/keys/{key_public_id}/reset-usage rydder nøgletælleren. total_spent er livstidsregnskab og nulstilles aldrig.

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

Nej. Alle Model API-nøgler bruger fra den ejer Model Gate-kontosaldo. Per-nøgle- og gruppegrænser begrænser brugen uden at opdele kontosaldoen i underordnede saldi.

Hvad sker der, når en Model API-nøgle roteres?

Den gamle hemmelighed holder op med at virke med det samme. Rotationssvaret indeholder den nye klarteksthemmelighed én gang. Opbevar det sikkert, fordi Model Gate ikke viser hele hemmeligheden igen.

Hvordan konfigureres tilbagekald?

Konfigurer callback_url og roter callback_secret i Model Gate-profilen. Asynkrone færdiggørelsesresultater sendes, når der findes en tilbagekalds-URL. Valgfri lav-nøgle-grænse, nøglegruppegrænse og lav kontosaldo-hændelser kan aktiveres separat; deres tærskler er konfigureret i profilmeddelelser.

Tilbagekaldslevering er holdbar og uafhængig af slutningsbehandling. Hvert arrangement har en stald event_id som forbliver uændret på tværs af genforsøg og skal bruges til forbrugerdeduplikering. Enhver HTTP 2xx svar er vellykket. Levering bruger højst 6 forsøg i alt, med genforsøg efter 5 sekunder, 30 sekunder, 2 minutter, 10 minutter og 1 time; hvert forsøg har en samlet timeout på 15 sekunder. Transportfejl, timeouts og ikke-2xx-svar forsøges igen, og efter det sjette mislykkede forsøg markeres hændelsen failed uden yderligere automatisk genforsøg. Se Tilbagekald for begivenhedskataloget, nøjagtige decimaler nyttelast, signaturer, destinationssikkerhed og leveringsdetaljer.

Hvor længe kan et asynkront resultat hentes?

Et asynkront resultat forbliver tilgængeligt i 24 timer GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Efter udløb slettes den gemte anmodning og svaret, og slutpunktet vender tilbage 404.

Understøtter partnermutationer sikkert genforsøg?

Ja. Hvert Partner API POST, PATCH, og DELETE kræver Idempotency-Key. Prøv igen den samme logiske handling med den samme tast efter en timeout; i 7 dage returnerer Model Gate det oprindelige resultat uden at udføre mutationen igen. Genbrug af en nøgle til en anden anmodning returnerer 409.

Hvor lang tid er detaljeret anmodningshistorik tilgængelig?

Detaljeret partneranmodningshistorik følger API_REQUESTS_HOT_RETENTION_DAYS (standard 7 dage) og rapporterer dette vindue i responsmetadata. Brug markørpaginerede kontosaldotransaktioner til langsigtet økonomisk afstemning.