Chuyển tới nội dung chính

Backend Service

This section documents the backend service APIs that power xperise's notifications and observability. Each page below is a standalone API reference with request bodies, field tables, authentication, and error responses.

Pages​

ServiceWhat it covers
Notification Center ServiceOTP delivery (ZNS / SMS) and booking notification endpoints (/otp, /bookingnoti, /request_booking) served by the notification-center service.
Log ServiceStructured log ingestion endpoints (/v1/logs, /v1/logs/mobile) that forward client logs to Loki via the api-gateway.
Store Service — Payment FlowThe checkout call sequence — cart reset, checkout session, corporate payment toggle, booking note, and pay_with_* execution.
Store Service — pay_with_corporateThe corporate payment call — what it needs from the session, and the errors specific to it.
Store Service — Middleware ErrorsAuthentication, authorization, delegation, and OTP errors raised before a request reaches the store service.
Store Service — Trip-Related ErrorsBudget, guest, and traveller validation failures on trip bookings, split by whether the trip has a proposal.
Flight Service — User Request FlowThe status flow for flight change and cancellation requests — admin quote as a list of fees, requester confirm or decline with the company's share of each fee, the requester's wallet payment, approval, and applying each fee to the passenger.
Flight Service — APIsRequester: user_requests, confirm_user_request, begin_personal_payment, decline_user_request, cancel_user_request. Admin: admin_user_requests, process_user_request, add_passenger_fee. Both: booking_request_progress.
Flight Service — Middleware ErrorsUNAUTHENTICATED and UNAUTHORIZED, raised before a request reaches a flight-service operation.
Flight Service — User Request ErrorsEvery user request error code, which call returns it, and when.
Card-coreThẻ, merchant, điều xe, trợ lý MCP, xác thực và vận hành của card-core — tài liệu chép từ repo card-core.

At a glance​

AreaEndpointsAuth
Notification Center — OTPPOST /otpNone
Notification Center — Booking / TripPOST /request_booking, POST /trip/requestx-client-api-key
Notification Center — Rental car / ExpensePOST /rental-car/*, POST /expense/*None
Notification Center — Devices & in-appGET|POST|DELETE /firebase-admin/*Authorization
Log ServicePOST /v1/logs, POST /v1/logs/mobileAuthorization token
Store Service — checkoutclear_shopping_items → begin_payment_checkout_session → confirm_payment → pay_with_*TBC
Flight Service — user requestsGraphQL /graphql/v1: user_requests, confirm_user_request, decline_user_request, cancel_user_request, admin_user_requests, process_user_request, add_passenger_fee, booking_request_progressAuthorization token; admin calls need the ADMIN role

Base URLs​

EnvironmentURL
Staginghttps://gw-staging.uts.network
Productionhttps://gw.uts.network