文档 / 测试

上线前集成测试

独立环境,用于验证 API、访问权限、测试数据、通知、错误、重复操作、报表及就绪标准,不影响生产系统。

环境
独立测试环境
数据
玩家与操作
场景
成功与错误情况
验收
就绪确认
测试流程

从访问开通到验收

01
准备测试环境

独立端点、访问密钥、通知、IP 规则及测试配置。

02
创建测试数据

玩家、货币、余额、提供商、方法及预设状态。

03
执行场景

成功、错误、重复、延迟及故障模式检查。

04
确认就绪

日志、报表、验收标准、负责人及切换生产环境的计划。

概览

测试环境应复现真实 API 行为

有效的测试环境应允许重复真实业务场景、控制结果、追踪每个请求,并安全测试错误而不影响生产数据或金融操作。

隔离环境

独立 API 端点、访问密钥、数据库、队列、通知端点及访问限制。

可控数据

可预测的玩家、余额、方法、提供商及状态,用于可重复场景。

正式验收

约定的场景、预期结果、报表及负责确认就绪状态的人员。

环境与访问

隔离测试与生产环境

测试和生产环境使用不同端点,并且不共享密钥、用户、通知或财务数据。

01

签发独立访问密钥

API 密钥、OAuth 客户端、签名密钥及服务账号仅为测试环境创建。

02

配置测试端点

主 API 端点、通知与返回端点、允许的 IP 及 TLS 设置应单独记录。

03

限制真实世界操作

测试环境不发送真实出款、邮件、短信、KYC 请求或其他外部金融操作。

04

记录差异

限额、提供商、数据、处理时间及可用场景方面的差异应记录在文档中。

测试数据

测试数据与可控状态

团队应提前明确哪些输入数据会产生所需结果,以及如何将环境恢复到初始状态。

测试玩家

活跃、被阻止、未验证、自我排除及其他固定状态的用户档案。

余额

可用、为零、不足、奖金及预留金额。

货币与精度

法币和数字货币、不同金额单位、舍入规则及不支持的组合。

提供商

可用、暂时停用、故障及受市场限制的连接。

游戏与产品

真钱模式、试玩模式、国家限制、停用产品及不同余额场景。

支付方式

成功操作、拒绝、处理中状态、3-D Secure、延迟、退款及出款。

客户验证与风险

已通过、待处理、已拒绝、人工审核、高风险及被阻止场景。

数据重置

无需人工干预即可重复恢复初始状态、创建新实体并清理操作。

测试场景

必测场景

测试计划应覆盖完整业务流程,包括网络错误、重新投递及状态恢复,而不是只测试单个 API 方法。

成功场景

从第一个请求到最终状态、财务记账及报表的完整流程。

错误场景

无效数据、禁止操作、余额不足、拒绝、服务不可用及验证失败。

重试与防重复

相同操作 ID、重复事件 ID 以及安全返回此前已创建的结果。

延迟与连接故障

响应缓慢、连接故障、通知延迟及操作结果未知。

乱序处理

迟到事件、最终状态先于中间状态到达,以及旧对象更新晚于新更新到达。

系统不可用

HTTP 5xx 错误、维护、提供商不可用、队列过载及后续恢复。

测试必须可复现

相同输入数据和所选模式应产生相同结果,以便团队重新验证修复。

日志与控制

测试环境诊断与管理

每个场景都应能通过请求、事件、操作 ID 或其他稳定标识符进行追踪。

日志与追踪

请求 ID 和关联 ID 应贯穿所有参与系统。
记录时间、端点、状态、错误码及处理结果。
支持按玩家、支付、回合、申请或事件 ID 搜索。
在不损失诊断所需信息的前提下遮蔽敏感字段。

场景控制

可选择预设的成功或错误结果。
可模拟延迟、重复通知、重复操作或提供商错误。
支持重置、重新投递及重新运行选定场景。
明确标识模拟环境与真实提供商测试环境之间的差异。
验收与上线

验收与上线切换

在 API、安全、业务场景、诊断及财务或运营报表均确认后,集成才视为就绪。

已确认的 API

端点、数据结构、状态、错误及版本规则与文档一致。

安全

已验证访问密钥、签名、角色、IP 规则及数据保护。

可靠性

能够安全处理重试、延迟、通知、取消及恢复。

运营控制

负责团队可以访问日志、指标、错误告警及诊断信息。

报表与对账

操作、状态、余额、提供商报表及内部报表结果一致。

就绪确认

产品、开发、测试、安全及运营团队均已确认可以上线。

上线前检查清单

完成验收并准备好受控上线计划后,才签发生产环境访问密钥。

测试与生产环境在端点、密钥、数据和通知方面完全隔离。
已完成成功、错误、重复及故障场景测试。
每个请求均可查询 ID、日志及处理结果。
已验证防重复、延迟及恢复机制。
报表、财务记录及控制总额一致。
已确认生产访问、监控、操作取消机制及支持联系人。

需要准备测试环境?

请提供文档、业务场景列表、可用环境及测试数据要求。APIACE 将帮助定义验证结构、验收标准及上线切换计划。