VantoShops Dev Docs
使用统一的 V10 API 构建商业、支付和系统集成。这里是开发者进入 VantoShops 的起点:从快速调用、认证方式到完整 API Reference 和生产运行能力。
What will you build?
从目标出发,而不是从接口列表出发。选择最接近你的开发任务,再进入对应的 API 领域。
Build commerce
构建商户、商品、客户、购物车、订单和 Checkout 生命周期。
Integrate payments
使用统一 PaymentIntent、路由、Provider、Capture、Refund 和 Timeline。
Connect systems
连接 Source、Processor、Webhook 和 Developer API,并保持租户与签名边界。
Make your first request
先验证 API 可达,再根据使用场景选择 Bearer 或 Developer HMAC。生产写操作同时受到 RBAC、Scope、Idempotency 和风险策略约束。
访问公开 Health endpoint,确认数据库和 Redis 均为正常。
三端使用 Bearer;Developer/Open/Integration 使用 Developer HMAC。
记录 X-Request-Id / X-Trace-Id,用于日志、队列和支付链路排障。
curl -sS https://apis.vantoshops.com/api/v10/health
{
"success": true,
"data": {
"architecture": "VantoShops V10",
"release": "10.8.157",
"status": "ok",
"checks": {"database": true, "redis": true}
}
}# Platform / Merchant / Agent APIs Authorization: Bearer <access_token> Accept: application/json # RBAC + membership + tenant context are resolved # before protected business resources execute.
# Developer / Open / Integration APIs X-Vanto-Key-Id: <public key id> X-Vanto-Timestamp: <unix timestamp> X-Vanto-Nonce: <unique nonce> X-Vanto-Signature: <HMAC-SHA256 signature> # Scope, CIDR, replay protection and quota are # enforced by the V10 developer security boundary.
Explore the API platform
按领域浏览 V10 API。每个模块共享统一的 Tenant、权限、审计和可追踪运行时契约。
Built for production
所有业务模块共同建立在这些运行时基础能力上,让 Commerce 与 Payments 在多租户环境中保持可控和可追踪。
请求进入业务服务前解析 Tenant、Merchant 和 Membership,隔离跨租户访问。
角色、权限与数据范围共同保护 Platform、Merchant、Agent 三端资源。
幂等键与持久化 Operation 状态减少网络重试带来的重复交易。
Request ID 与 Trace ID 贯穿 HTTP、日志、队列和异步业务链路。
Webhook 和异步任务使用 Redis Queue 与 Outbox 构建可靠执行链。
Stripe、PayPal、Airwallex、Antom 通过统一 Payment Provider Contract 接入。
Operate with confidence
开发者门户直接读取运行时 Health;版本和 API 契约保持可见。
Canonical V10 API base remains /api/v10. The Developer Portal does not change protected API contracts.
Developer resources
从参考、运行状态、安全边界和集成入口快速进入后续工作。
搜索、过滤并在线测试完整 V10 endpoint catalog。
Browse references →QSQuickstart从 Health、Bearer 与 Developer HMAC 开始第一条请求。
Start building →HLHealth Center查看 API、Database、Redis 与 Release 的实时健康状态。
View health →SECProduction architecture理解 Tenant、RBAC、Idempotency、Tracing 与 Queue 运行边界。
Review architecture →