统一后台子系统接入说明

所有组织级接口必须携带当前组织上下文，业务数据按 orgId 和 subsystemKey 逻辑隔离。

认证头

Authorization: Bearer <token>
X-Org-Id: <organization-id>
X-Subsystem-Key: <subsystem-key>

接口分组

• /api/platform/*：超级管理员接口。
• /api/org/*：组织用户接口。
• /api/subsystem/*：子系统服务接口，必须携带 X-Org-Id、X-Subsystem-Key 和子系统 token。
• /mcp：MCP HTTP endpoint。

超级货代管家

super-freight 是 tokencn 组织下的子系统。统一后台托管它的询价/报价、外部平台、财务邮箱、模型策略、通道、设备和审计主数据。

GET /api/sf/catalog
GET /api/sf/me
GET /api/sf/inquiries/org
POST /api/sf/inquiries/org/quotes
GET /api/sf/quotes/search
GET /api/sf/external-platforms
POST /api/sf/external-platforms/:platform/auth
GET /api/sf/finance/mail/accounts
POST /api/sf/finance/mail/accounts
GET /api/sf/model-policy
PATCH /api/sf/orgs/:orgId/model-policy
GET /api/sf/channel-settings
PATCH /api/sf/channel-settings
GET /api/sf/devices
POST /api/sf/devices/enroll
GET /api/sf/audit-logs

后台维护入口使用 /api/org/super-freight/resources，MCP 工具包括 list_super_freight_resources、create_super_freight_resource 和 update_super_freight_resource。

OpenAPI 文档：/docs/openapi