Русский
Українська
ქართული
English
Қазақша
Español
Français
Deutsch
Italiano
فارسیԸնդհանուր նկարագրություն
Հանրային /api/health endpoint-ը վերադարձնում է VPOS.am հարթակի runtime-ի և readiness-ի ընդհանրացված, գաղտնիքներ չպարունակող կարգավիճակը։
Հարթակի ընթացիկ համախմբված վիճակ
Վիջեթը կարդում է ոչ գաղտնի same-origin health endpoint-ը և ցույց է տալիս միայն սահմանափակ հանրային պատրաստականության ամփոփագիր։
Ինչ է ցույց տալիս հանրային health-ը
GET /api/health-ը վերադարձնում է ok, ready, service, version, mode, generatedAt և ընդհանրացված readiness object։ Վերին մակարդակի ready դաշտը հարմար է ընդհանուր uptime/readiness ստուգման համար, իսկ blockers-ը և warnings-ը օգնում են ախտորոշել հարթակի վիճակը։
Blocker-ների ախտորոշիչ տեքստը կայուն API contract չէ։ Ավտոմատ monitoring-ը պետք է հիմնվի փաստաթղթավորված դաշտերի վրա և պահպանի generatedAt-ը՝ թարմ պատասխանը հնացած տվյալից տարբերելու համար։
Ընդհանրացված կարգավիճակի սահմանը
ready=true նշանակում է, որ ընդհանուր runtime-ն անցել է ընթացիկ platform-level ստուգումները։ Այն չի ապացուցում, որ կոնկրետ merchant-ն ունի գործող պայմանագիր, credentials, installation binding, callback, fiscal profile կամ հաստատված production provider route։
Merchant-specific readiness-ը հաստատվում է առանձին՝ console/onboarding flow-ով և test payment-ով։ Արտաքին bank-ի կամ provider-ի վիճակը նույնպես հնարավոր չէ եզրակացնել միայն VPOS-ի ընդհանուր health response-ից։
Ինչպես օգտագործել signal-ը շահագործման ժամանակ
Monitoring-ը կարող է պարբերաբար հարցնել /api/health-ը և տեղեկացնել operations-ին, երբ ready=false է կամ թարմ պատասխան չկա։ Առանձին payment, webhook delivery կամ provider callback պետք է ուսումնասիրել payment id-ով, merchantOrderId-ով և տվյալ installation-ի logs-ով։
Հանրային health-ը ոչ SLA-ի խոստում է, ոչ էլ incidents history։ Կոնկրետ client-ի վրա հաստատված ազդեցությունը և վերականգնման քայլերը հաղորդվում են համաձայնեցված support channels-ով։
Հաճախակի հարցեր
Ի՞նչ է նշանակում ready-ն /api/health response-ում։
Դա generatedAt պահին ընթացիկ platform-level readiness checks-ի ընդհանրացված արդյունքն է։ Այն հարմար է ընդհանուր runtime monitoring-ի համար, բայց չի հաստատում կոնկրետ merchant-ի կամ provider route-ի պատրաստ լինելը։
ready=true-ն հաստատո՞ւմ է merchant-ի production readiness-ը։
Ոչ։ Կոնկրետ installation-ի համար առանձին ստուգվում են contract-ը և credentials-ը, token binding-ը, provider route-ը, callbacks/webhooks-ը, test payment-ը և production approval-ը։