Partner API Vanliga frågor

Vad är skillnaden mellan en konto-API-nyckel och en Model API-nyckel?

API-nyckeln på kontonivå (mg_partner_...) hanterar Model API-nycklar genom https://p-api.model-gate.com/api/v1/partner/* och hämtar asynkrona resultat genom https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

En modell API-nyckel (mg_live_...) autentiserar slutledningsbegäranden genom https://api.model-gate.com.

Skicka aldrig en Partner API-nyckel på kontonivå till en slutpunkt för slutledning eller exponera den i program på klientsidan.

Vilket motverkar spend_limit?

Den återställbara usage counter upprätthåller gränsen. POST /api/v1/partner/keys/{key_public_id}/reset-usage rensar nyckelräknaren. total_spent är livstidsredovisning och återställs aldrig.

Har varje modell API-nyckel ett separat kontosaldo?

Nej. Alla Model API-nycklar spenderas från det ägande saldot på Model Gate-kontot. Per-nyckel- och gruppgränser begränsar användningen utan att dela upp kontosaldot i underordnade saldon.

Vad händer när en modell API-nyckel roteras?

Den gamla hemligheten slutar fungera direkt. Rotationssvaret innehåller den nya klartexthemligheten en gång. Förvara den säkert eftersom Model Gate inte visar hela hemligheten igen.

Hur konfigureras återuppringningar?

Konfigurera callback_url och rotera callback_secret i Model Gate-profilen. Asynkrona slutföranderesultat skickas när en återuppringnings-URL finns. Valfri låg-key-limit, Key Group limit och låg-konto-saldo händelser kan aktiveras separat; deras tröskelvärden konfigureras i profilmeddelanden.

Återuppringningsleverans är hållbar och oberoende av slutledningsbearbetning. Varje evenemang har ett stall event_id som förblir oförändrad över flera försök och måste användas för konsumentdeduplicering. Vilken HTTP som helst 2xx svaret är framgångsrikt. Leveransen använder högst 6 försök totalt, med återförsök efter 5 sekunder, 30 sekunder, 2 minuter, 10 minuter och 1 timme; varje försök har en total timeout på 15 sekunder. Transportfel, timeout och icke-2xx-svar görs om, och efter det sjätte misslyckade försöket markeras händelsen failed utan ytterligare automatiska försök. Se Återuppringningar för evenemangskatalogen, nyttolaster med exakt decimal, signaturer, destinationssäkerhet och leveransdetaljer.

Hur länge kan ett asynkront resultat hämtas?

Ett asynkront resultat förblir tillgängligt i 24 timmar GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Efter utgången raderas den lagrade begäran och svaret och slutpunkten återgår 404.

Stöder partnermutationer säkert omförsök?

Ja. Varje Partner API POST, PATCH, och DELETE kräver Idempotency-Key. Försök igen samma logiska operation med samma nyckel efter en timeout; i 7 dagar returnerar Model Gate det ursprungliga resultatet utan att utföra mutationen igen. Återanvändning av en nyckel för en annan begäran returneras 409.

Hur lång är detaljerad förfrågningshistorik tillgänglig?

Detaljerad partnerförfrågningshistorik följer API_REQUESTS_HOT_RETENTION_DAYS (standard 7 dagar) och rapporterar det fönstret i svarsmetadata. Använd markörpaginerade kontosaldotransaktioner för långsiktig finansiell avstämning.