开发接入指南 v2.4.0

本指南面向合作伙伴与系统集成商，提供标准化的服务接入路径。通过我们的安全分发协议，您可以实现在自有业务系统内动态调取美洽或快连的最新指引资源。

1. 快速接入

所有分发请求必须基于 HTTPS 协议，并通过 Base64 编码的指令集进行交互。

curl -X GET "https://api.yourdomain.com/v2/fetch_gate?node=global" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

2. 鉴权与安全性

为了保障分发链路的安全性，本系统采用 AES-256-GCM 加密对跳转路径进行动态封装。开发者在前端调用时，建议使用临时令牌。

参数名 类型 描述
app_id String 您的开发者唯一标识
timestamp Long Unix 时间戳，有效期 300s
signature String HMAC-SHA256 签名算法结果

3. 分发路径端点 (Endpoints)

GET /dist/package/latest

返回当前各平台（Windows, Android, iOS）的最新指引信息。

{
  "code": 200,
  "data": {
    "platform": "win64",
    "target_gate": "aHR0cHM6Ly9sZWV0c3MuY29tLw==",
    "version": "5.4.1"
  },
  "msg": "success"
}

4. 错误码标准

本系统遵循标准的 HTTP 状态响应：