justsolutionsWeb — 后端 API 调用清单

1. 调用架构概览

所有业务 API 调用都收口在统一的 HttpService（src/app/services/http.service.ts）：

• 基地址：请求时把相对路径拼到 environment.apis.url 之后，即 environment.apis.url + request.url。
• 鉴权：自动从 localStorage 或 sessionStorage 读取 aml_access_token，存在时加上请求头 Authorization: Bearer <token>。
• 请求模型：统一使用 Http.Request<T>（src/app/models/http.ts），字段含 method / url / body / params / headers / responseType 等。

1.1 环境与基地址配置

• apis.amlUrl：仅用于 plans 页面与父窗口（AML 门户 iframe 宿主）之间的 postMessage 通信，并非 HTTP 端点。
• apis.test：为 true 时支付金额固定写死为 10（分），用于测试支付（见第 6 节）。

2. 调用清单（按端点汇总）

3. 鉴权（OAuth Token）

端点 1 — POST /connect/token?__tenant=2C

• 位置：AmlQueryService。在该服务构造函数中自动触发：当 localStorage 无 aml_access_token 时，调用 getToken() 并把返回的 access_token 写入 localStorage。
• 请求头：Content-Type: application/x-www-form-urlencoded

Body（x-www-form-urlencoded，硬编码凭证）：

4. AML 查询模块（aml-query）

端点 2 — GET /api/aml/ConsumerPortal/GetPrice/{inputCode}

• 调用方：aml-query-layout.component.ts（ngOnInit 时以 getPrice('E') 拉取价格）。
• 价格的真正计算逻辑在 AmlQueryService.calculatePrice()（本地计算，不走接口）。

5. 联系我们模块（contact）

调用方：contact/pages/contact/contact.component.ts 提交表单时触发。

• 端点 3 POST /api/amlPortal/customer/CreateFeedback：保存反馈记录。
  Body（CreateFeedbackParam）：companyName、customerName、customerEmail、typeOfQuery、message、userHost、destEmail、emailSubject、emailBody。
• 端点 4 POST /api/aml/emailQueue/CreateEmailQueue：进入邮件发送队列，被调用两次：
  • sendContactEmail() → 通知管理员（收件人 environment.email.contact）。
  • sendContactByReturnEmail() → 给提交者发送回执邮件（收件人为用户填写邮箱）。
  Body（CreateEmailQueueParam）：subject、to、body(HTML)、businessType: 2100、businessId: ''。

6. 套餐与下单模块（plans / Order）

PlanService 集中了套餐查询、校验与下单接口。各端点的页面调用关系：

关键请求体

• getAllPlanList（GetPlanListParam）：pageIndex: 0、pageSize: 9999、tag1List: ['B','jQ','j','AdlU','KYC']、tag2List/tag3List（由调用方传入）、agentUserId。
• getCountryList：{ typeCodes: ['COUNTRY'] }。
• checkBRCI：通过 params 传 br / ci（query string）。
• createOrder（CreateOrderParam）：planList[]（planId/planDetailId/pcs）、tenantName、tenantAdminEmail、jurisdiction、organizationBR、organizationCI、organizationReference、contactPerson、companyAddress、phone、effectiveStartTime、agentorId、isOfflinePayment: false、isAgentBehalf。
• tenantRenewal（TenantRenewalParam）：targetTenantID、planList[]、agentorId、tenantAdminEmail、isOfflinePayment: false、isAgentBehalf。

6.1 支付跳转（QFPay 外部网关，不经过 HttpService）

位置：plan4.component.ts 的 payFn()。下单成功（createOrder/tenantRenewal 返回 code === 0）后：

• 若订单 paymentStatus === 200 或 txamt === 0 → 直接跳转 plans-plus/payment-success。
• 否则通过 location.href 重定向到 QFPay 收银台：
  https://openapi-hk.qfapi.com/checkstand/#/?<参数>&sign=<sha256>

主要参数：

7. 端点前缀分布

8. 速查 · 典型流程（按调用次序）

• 应用启动：AmlQueryService 构造 → 端点 1 取 token。
• AML 查询页加载：端点 2 取价格。
• 联系页提交：端点 3 + 端点 4（×2）。
• 套餐购买流程：
  1. 进入套餐页：端点 5、6、7。
  2. 填写租户/续费信息：端点 8（优惠码）、9（租户）、10（BR/CI）、11（邮箱）。
  3. 确认下单：端点 12（新购）或 13（续费）。
  4. 跳转 QFPay 支付 → 支付完成后 QFPay 回调端点 14。