Partner API Veelgestelde vragen

Wat is het verschil tussen een account-API-sleutel en een model-API-sleutel?

De API-sleutel op accountniveau (mg_partner_...) beheert Model API-sleutels via https://p-api.model-gate.com/api/v1/partner/* en haalt asynchrone resultaten op via https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Een model-API-sleutel (mg_live_...) verifieert gevolgtrekkingsverzoeken via https://api.model-gate.com.

Stuur nooit een sleutel op accountniveau Partner API naar een inferentie-eindpunt en stel deze nooit beschikbaar in toepassingen aan de clientzijde.

Welke teller afdwingt spend_limit?

Het resetbare usage counter handhaaft de limiet. POST /api/v1/partner/keys/{key_public_id}/reset-usage wist de sleutelteller. total_spent is levenslange boekhouding en wordt nooit gereset.

Heeft elke Model API-sleutel een afzonderlijk accountsaldo?

Nee. Alle Model API-sleutels worden uitgegeven vanuit het eigen Model Gate-accountsaldo. Limieten per sleutel en groep beperken het gebruik zonder het accountsaldo op te splitsen in onderliggende saldi.

Wat gebeurt er als een Model API-sleutel wordt geroteerd?

Het oude geheim werkt onmiddellijk niet meer. Het rotatieantwoord bevat één keer het nieuwe leesbare tekstgeheim. Bewaar het veilig, want Model Gate geeft niet opnieuw het volledige geheim weer.

Hoe worden terugbelverzoeken geconfigureerd?

Configureer callback_url en roteren callback_secret in het Model Gate-profiel. Asynchrone voltooiingsresultaten worden verzonden wanneer er een callback-URL bestaat. Optionele gebeurtenissen met een lage sleutellimiet, sleutelgroeplimiet en een laag rekeningsaldo kunnen afzonderlijk worden ingeschakeld; hun drempelwaarden worden geconfigureerd in Profielmeldingen.

Terugbellevering is duurzaam en onafhankelijk van gevolgtrekkingsverwerking. Bij elk evenement hoort een stal event_id die bij nieuwe pogingen ongewijzigd blijft en moet worden gebruikt voor deduplicatie van consumenten. Elke HTTP 2xx reactie is succesvol. Bij bezorging zijn in totaal maximaal 6 pogingen nodig, met nieuwe pogingen na 5 seconden, 30 seconden, 2 minuten, 10 minuten en 1 uur; elke poging heeft een totale time-out van 15 seconden. Transportfouten, time-outs en niet-2xx-reacties worden opnieuw geprobeerd en na de zesde mislukte poging wordt de gebeurtenis gemarkeerd failed zonder verdere automatische nieuwe poging. Zien Terugbelgesprekken voor de evenementencatalogus, exacte decimale payloads, handtekeningen, bestemmingsbeveiliging en leveringsgegevens.

Hoe lang kan een asynchroon resultaat worden opgehaald?

Een asynchroon resultaat blijft 24 uur beschikbaar GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Na het verlopen worden het opgeslagen verzoek en antwoord verwijderd en keert het eindpunt terug 404.

Ondersteunen partnermutaties veilig opnieuw proberen?

Ja. Elke Partner API POST, PATCH, En DELETE vereist Idempotency-Key. Probeer dezelfde logische bewerking opnieuw met dezelfde sleutel na een time-out; gedurende 7 dagen retourneert Model Gate het oorspronkelijke resultaat zonder de mutatie opnieuw uit te voeren. Het hergebruiken van een sleutel voor een ander verzoek keert terug 409.

Hoe lang is de gedetailleerde verzoekgeschiedenis beschikbaar?

Gedetailleerde partnerverzoekgeschiedenis volgt API_REQUESTS_HOT_RETENTION_DAYS (standaard 7 dagen) en rapporteert dat venster in antwoordmetadata. Gebruik met cursor gepagineerde rekeningsaldotransacties voor financiële afstemming op langere termijn.