Partner API FAQ

Kāda ir atšķirība starp konta API atslēgu un modeļa API atslēgu?

Konta līmeņa API atslēga (mg_partner_...) pārvalda modeļa API atslēgas, izmantojot https://p-api.model-gate.com/api/v1/partner/* un izgūst asinhronos rezultātus, izmantojot https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Modeļa API atslēga (mg_live_...) autentificē secinājumu pieprasījumus, izmantojot https://api.model-gate.com.

Nekad nesūtiet konta līmeņa Partner API atslēgu uz secinājuma galapunktu un neatklājiet to klienta puses lietojumprogrammās.

Kuru skaitītājs izpilda spend_limit?

Atiestatāms usage skaitītājs ievieš limitu. POST /api/v1/partner/keys/{key_public_id}/reset-usage notīra atslēgu skaitītāju. total_spent ir mūža uzskaite un nekad netiek atiestatīta.

Vai katrai modeļa API atslēgai ir atsevišķs konta atlikums?

Nē. Visas Model API atslēgas tērē no Model Gate konta atlikuma. Atslēgas un grupas ierobežojumi ierobežo lietošanu, nesadalot konta atlikumu pakārtotajos atlikumos.

Kas notiek, kad modeļa API atslēga tiek pagriezta?

Vecais noslēpums nekavējoties pārstāj darboties. Rotācijas atbilde vienreiz satur jauno vienkāršā teksta noslēpumu. Glabājiet to droši, jo Model Gate vairs nerāda visu noslēpumu.

Kā tiek konfigurēti atzvani?

Konfigurēt callback_url un pagriezt callback_secret Model Gate profilā. Asinhronās pabeigšanas rezultāti tiek nosūtīti, ja pastāv atzvanīšanas URL. Atsevišķi var iespējot neobligātos zemā atslēgas limita, atslēgu grupas limita un zema konta bilances notikumus; to sliekšņi ir konfigurēti profila paziņojumos.

Atzvanīšanas piegāde ir izturīga un neatkarīga no secinājumu apstrādes. Katrs pasākums nes stallis event_id kas paliek nemainīgs visos atkārtotos mēģinājumos un ir jāizmanto patērētāja dublēšanai. Jebkurš HTTP 2xx atbilde ir veiksmīga. Piegāde izmanto ne vairāk kā 6 mēģinājumus, ar atkārtotu mēģinājumu pēc 5 sekundēm, 30 sekundēm, 2 minūtēm, 10 minūtēm un 1 stundas; katram mēģinājumam ir 15 sekunžu kopējais taimauts. Transportēšanas kļūdas, taimauta un atbildes, kas nav 2xx, tiek mēģinātas atkārtoti, un pēc sestā neveiksmīgā mēģinājuma notikums tiek atzīmēts failed bez turpmāka automātiska atkārtota mēģinājuma. Skat Atzvani pasākuma katalogam, precīzās decimāldaļas, parakstus, galamērķa drošību un piegādes informāciju.

Cik ilgi var izgūt asinhrono rezultātu?

Asinhronais rezultāts ir pieejams 24 stundas GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Pēc derīguma termiņa beigām saglabātais pieprasījums un atbilde tiek dzēsti un galapunkts atgriežas 404.

Vai partneru mutācijas atbalsta drošu atkārtotu mēģinājumu?

Jā. Ik pēc Partner API POST, PATCH, un DELETE prasa Idempotency-Key. Pēc taimauta mēģiniet vēlreiz to pašu loģisko darbību ar to pašu taustiņu; 7 dienas Model Gate atgriež sākotnējo rezultātu, neveicot mutāciju vēlreiz. Atgriežas atslēgas atkārtota izmantošana citam pieprasījumam 409.

Cik ilgi ir pieejama detalizēta pieprasījumu vēsture?

Tālāk ir sniegta detalizēta partneru pieprasījumu vēsture API_REQUESTS_HOT_RETENTION_DAYS (noklusējuma 7 dienas) un ziņo par šo logu atbildes metadatos. Izmantojiet kursora lappuses konta bilances darījumus ilgtermiņa finanšu saskaņošanai.