外部接口 设想

第三方服务集成规范

接口清单

金价接口

API-01
高优先级

获取实时金价数据，支持主备数据源切换

REST API 上海黄金交易所

电子签章接口

API-02
高优先级

合同在线签署、验签、存证服务

REST API 签章服务商

短信通知接口

API-03
高优先级

发送短信验证码和业务通知

REST API 短信服务商

邮件通知接口

API-04
中优先级

发送邮件通知和报表

SMTP 邮件服务

物流查询接口

API-05
中优先级

查询运单物流状态信息

REST API 物流聚合平台

身份证OCR接口

API-06
中优先级

身份证信息自动识别（预留）

REST API OCR服务商

支付接口

API-07
高优先级

支持银行卡、支付宝、微信等多渠道收款

REST API 聚合支付服务商

税务/发票接口

API-08
高优先级

电子发票开具、红冲、查验服务

REST API 税控服务商/税务局

实名认证接口

API-09
高优先级

身份证+姓名二要素核验，支持活体检测

REST API 公安部/认证服务商

制裁名单筛查接口

API-10
高优先级

反洗钱合规要求，客户风险名单筛查

REST API 合规数据服务商

接口规范

通信协议
HTTPS
数据格式
JSON (UTF-8)
认证方式
API Key + 签名验证
超时设置
连接 5s / 读取 30s
重试策略
失败重试 3 次，间隔递增

容错机制

金价接口故障

切换备用数据源，使用缓存金价并标注时间

签章服务中断

暂停签署功能，启用线下签署备案流程

短信发送失败

切换备用通道，记录待发送队列重试

物流查询失败

展示"暂无物流信息"，后台定时重试

支付接口故障

切换备用支付通道，提示客户使用其他支付方式

发票接口中断

记录待开票队列，服务恢复后自动补开并通知客户

实名认证失败

切换备用认证通道，或提示人工审核流程

名单筛查服务中断

暂停新客户交易，已认证客户可继续，记录待筛查队列

接口调用示例

金价查询接口示例

GET /api/v1/gold-price/realtime 
// 请求头
{
    "Authorization": "Bearer {token}",
    "X-Request-Id": "uuid-xxx-xxx"
}

// 响应示例
{
    "code": 200,
    "message": "success",
    "data": {
        "price": 480.50,
        "unit": "元/克",
        "source": "上海黄金交易所",
        "updateTime": "2024-01-15 10:30:00"
    },
    "timestamp": 1705289400000
}

主要服务商对比

服务类型 服务商A 服务商B 推荐
电子签章 e签宝 法大大 待评估
短信服务 阿里云短信 腾讯云短信 待评估
物流查询 快递100 快递鸟 待评估
OCR识别 阿里云OCR 百度云OCR 待评估
聚合支付 支付宝/微信官方 Ping++/汇付天下 待评估
电子发票 航天信息 百望云 待评估
实名认证 阿里云实人认证 腾讯云人脸核身 待评估
制裁名单筛查 道琼斯/世界合规 汤森路透 待评估

集成计划

第一阶段 W1-W6
短信服务集成
实名认证对接
制裁名单筛查对接
第二阶段 W7-W14
金价接口对接
支付接口对接
税务/发票接口对接
第三阶段 W15-W19
电子签章对接
物流查询对接
第四阶段 W20-W24
OCR识别（可选）
邮件通知（可选）