Partner API FAQ

Koja je razlika između API ključa računa i API ključa modela?

API ključ na razini računa (mg_partner_...) upravlja API ključevima modela putem https://p-api.model-gate.com/api/v1/partner/* i dohvaća asinkrone rezultate putem https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

API ključ modela (mg_live_...) provjerava autentičnost zahtjeva za zaključivanje putem https://api.model-gate.com.

Nikada ne šaljite ključ Partner API na razini računa krajnjoj točki zaključivanja niti ga izlažite u aplikacijama na strani klijenta.

Koji brojač provodi spend_limit?

Mogućnost resetiranja usage brojač provodi ograničenje. POST /api/v1/partner/keys/{key_public_id}/reset-usage briše brojač tipki. total_spent je doživotno računovodstvo i nikada se ne resetira.

Ima li svaki Model API ključ zasebno stanje računa?

Ne. Svi Model API ključevi troše iz stanja vlastitog Model Gate računa. Ograničenja po ključu i grupi ograničavaju upotrebu bez dijeljenja stanja računa na podređena stanja.

Što se događa kada se ključ Model API-ja rotira?

Stara tajna odmah prestaje djelovati. Odgovor rotacije sadrži novu tajnu otvorenog teksta jednom. Pohranite ga na sigurno jer Model Gate više ne prikazuje cijelu tajnu.

Kako se konfiguriraju povratni pozivi?

Konfigurirati callback_url i rotirati callback_secret u profilu Model Gate. Rezultati asinkronog završetka šalju se kada postoji URL povratnog poziva. Dodatni događaji niskog ključa, ograničenja ključne grupe i niskog stanja računa mogu se omogućiti zasebno; njihovi su pragovi konfigurirani u obavijestima profila.

Isporuka povratnog poziva je trajna i neovisna o obradi zaključivanja. Svaki događaj nosi štalu event_id koji ostaje nepromijenjen tijekom ponovnih pokušaja i mora se koristiti za deduplikaciju korisnika. Bilo koji HTTP 2xx odgovor je uspješan. Isporuka koristi najviše 6 pokušaja ukupno, s ponovnim pokušajima nakon 5 sekundi, 30 sekundi, 2 minute, 10 minuta i 1 sat; svaki pokušaj ima ukupno vremensko ograničenje od 15 sekundi. Pogreške u prijenosu, istek vremena i odgovori koji nisu 2xx pokušavaju se ponovno, a nakon šestog neuspjelog pokušaja događaj se označava failed bez daljnjeg automatskog ponovnog pokušaja. Vidjeti Povratni pozivi za katalog događaja, točne decimalne nosivosti, potpise, sigurnost odredišta i pojedinosti o isporuci.

Koliko dugo se asinkroni rezultat može dohvatiti?

Asinkroni rezultat ostaje dostupan 24 sata GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Nakon isteka, pohranjeni zahtjev i odgovor se brišu i vraća se krajnja točka 404.

Podržavaju li partnerske mutacije siguran ponovni pokušaj?

Da. Svaki Partner API POST, PATCH, i DELETE zahtijeva Idempotency-Key. Ponovno pokušajte istu logičku operaciju s istim ključem nakon isteka vremena; tijekom 7 dana Model Gate vraća izvorni rezultat bez ponovnog izvršavanja mutacije. Ponovno korištenje ključa za drugačiji zahtjev vraća 409.

Koliko dugo je dostupna detaljna povijest zahtjeva?

Slijedi detaljna povijest zahtjeva za partnere API_REQUESTS_HOT_RETENTION_DAYS (zadano 7 dana) i prijavljuje taj prozor u metapodacima odgovora. Koristite kursorom paginirane transakcije stanja računa za dugoročnije financijsko usklađivanje.