Partner API

Број {0} је намењен банкама, ботовима, панелима препродавача, интерним системима за обезбеђивање и другим поузданим интеграцијама између сервера. Верзија 10.5.0 је први уговор о машини спреман за банку.

Основни УРЛ

https://p-api.model-gate.com

Аутентификација

Authorization: Bearer mg_partner_...

Сваки одговор је ЈСОН, укључујући 404, 405, 429, и 500, и укључује X-Request-ID. Одговори користе Cache-Control: no-store; хост партнера не користи ПХП сесије претраживача. Све спољне временске ознаке су УТЦ РФЦ3339 (YYYY-MM-DDTHH:MM:SSZ).

Све POST, PATCH, и DELETE операције захтевају јединствену Idempotency-Key заглавље. Модел капија чува шифровани резултат 7 дана, тако да поновни покушај истог захтева враћа оригинални резултат без поновног вршења мутације. Поновна употреба истог кључа за другачији метод/путњу/тело враћа ХТТП 409.

Захтеви за партнере су заштићени ограничењем брзине по минуту на нивоу налога које је конфигурисао PARTNER_API_RATE_LIMIT_PER_MINUTE (подразумевано 600). Одговори укључују X-RateLimit-Limit, X-RateLimit-Remaining, и X-RateLimit-Reset; ХТТП 429 такође укључује Retry-After.

Креирајте или поново генеришите кључ Partner API у профилу капије модела. Комплетан токен носиоца се приказује само једном приликом генерисања/ротације и Модел Гате чува само свој СХА-256 хеш плус префикс приказа. Одмах сачувајте токен у свом тајном менаџеру на страни сервера; ако се изгуби, окрените га.

Профил има посебан АПИ ИП листа дозвољених. Када није празан, захтеви Partner API морају да потичу са дозвољене тачне ИПв4/ИПв6 адресе или ЦИДР префикса. Правила АПИ-ја пословне организације важе као додатак личном правилу. Извор који је одбио било која ефективна листа дозвољених прима ХТТП 403 са error.type = ip_not_allowed.

За пословне налоге, акредитив Partner API је доступан само верификованом власнику организације. Директорима запослених и делегираним додељивањем пословних акредитива управља се на веб панелу, где се могу потврдити дозволе за групно извршавање. Пословни кључеви креирани од стране партнера стога користе власника и као власника обрачуна и као принципала акредитива. А испоручено group_id мора именовати активну групу у власништву налога; непозната/замрзнута група је одбијена са ХТТП-ом 422 уместо тихог креирања негруписаног кључа.

Децималне вредности

Поља за финансије и коришћење су увек ЈСОН стрингови:

{
  "spend_limit": "100.0000000000",
  "usage": "12.3456789000",
  "remaining": "87.6543211000",
  "usage_price_multiplier": "0.900000"
}

Користите децималну аритметику произвољне прецизности. Никада не претварајте ове вредности у float.

Могућности

• Креирајте, листајте, ажурирајте, ротирајте, замрзните, одмрзните и избришите АПИ кључеве.
• Конфигуришите процену употребе по кључу.
• Креирајте групе и управљајте њима.
• Померајте тастере између група.
• Прочитајте употребу кључа и групе.
• Прочитајте финализовану историју захтева за кључ у редоследу у време завршетка са страницама од 1–100 редова и разделом токена/цене. Детаљна историја захтева се чува за API_REQUESTS_HOT_RETENTION_DAYS (подразумевано 7 дана); дугорочно финансијско усаглашавање користи дневник трансакција стања.
• Прочитајте стање на текућем рачуну и трансакције стања рачуна са пагинацијом курсора.
• Прочитајте догађаје ревизије управљања партнерима са пагинацијом курсора.
• Резултати асинхроног закључивања анкете.

Видите свих Partner API крајњих тачака за комплетне примере захтева и одговора.

Недавни записи о историји захтева укључују principal_user_id када налогодавац још увек постоји, одвојено од власника компаније за обрачун.

Машински читљив уговор

ОпенАПИ 3.1 уговор се испоручује са сваким издањем као resources/contracts/partner-api.openapi.yaml. Третирајте га заједно са овим Partner API страницама као уговором о интеграцији Банке. Непозната ЈСОН поља и непознати параметри упита се одбијају уместо да се тихо игноришу.