SOLAVIA · 文档

文档站:认证、接口、错误码、示例

本页是 Solavia API 的公开文档入口:如何认证、有哪些接口、错误码含义、可直接复制的 curl 示例。所有示例均为沙箱口径(SIM_PGK、mock Sevis、零真实 PII)。

Base URL

https://api.solavia.io

沙箱:demo.solavia.io 的 /api(invite-only)。本页命令以 <base> 占位。

认证两步

  1. 请求头带租户 X-API-Key
  2. POST /auth/login(subject + password)换会话令牌
  3. 后续请求带 X-Session-Token(或 API Key 直接访问允许的路由)

版本与规模

契约版本:v1.4.0(OpenAPI 3.1)
接口数(按契约文件):—
错误码(字典):—

沙箱边界:全部金额为 SIM_PGK 沙箱模拟、不入真实账本;身份为 mock Sevis(不接真实 Sevis);零真实 PII;demo 为 invite-only、无 SLA。

从哪里开始

先看 endpoints 找到路由与角色,再看 errors 的错误码含义,最后复制 examples 的 curl 在沙箱跑一遍。

不做什么

不发行身份、不持有国民 PII、不持牌清结算;文档描述沙箱与设计,不代表生产上线或认证。