南兴开放平台
  1. 开发前必读
南兴开放平台
  • 开发前必读
    • 1.开发须知
    • 2.key-auth授权
    • 3. para-hmac-auth签名算法
    • 4.接口调用
    • 5.集成规范总体原则
    • 6.更新日志
    • 7.常见问题
  • ERP
    • 经销商平台
      • 经销商查询BOM子项接口
      • Bom多阶查询
      • 查询客户信息接口
      • 经销商生成U9销售订单接口
      • 同步配件库存及价格
      • 查询经销商价目表配件料品信息
    • 配件商城
      • 配件商城查库存
      • 查询料品库存价格
      • 配件商城生成销售订单
    • 用序列号查询是否存在U9系统
      POST
  • NXLINK
    • 南兴link消息发送
      POST
    • 南兴link效验Ticket
      POST
  • OA
    • 流程管理
      • 查询流程信息
      • 新建流程
  • 人事考勤
    • 2号人事
      • 获取token
  • 企查查
    • 企业信息
      • 企业高级搜索
  • 短信
    • 发送短信
      POST
  • 事件管理
    • 事件数据回调
    • 发送事件数据
      POST
  1. 开发前必读

5.集成规范总体原则

API网关对接的所有业务系统需要遵循如下原则:
1.
API网关原则上不对报文进行解析;
2.
接口请求方法上下游原则上保持一致;
3.
系统通讯协议原则:
企业内部的服务提供方和服务消费方使用HTTP协议。
内部不同网络区域的网关之间转发使用HTTPS。
外部合作的服务提供方和服务消费方通讯使用HTTPS。
4.
API网关入口支持的协议包括:Web Service、RESTful,建议统一使用 Restful风格的API;
5.
接口传输的参数、报文签名、验签、加密等都采用utf-8的字符集编码
6.
报文参数需要是JSON报文格式 ,暂不支持其他方式
7.
报文数据大小默认1M,最大不能超过4M,接口数据报文大小建议1M以下,超过1M时需要通知API管理人员调整
8.
所有对外的API以及不同网络区域的API交互使用的SSL/TLS协议,协议版本建议1.2以上;
9.
请求不同网络区域的API消费方需要按照API规范按照附录章节说明进行加验签;
10.
对外的API消费方需要提供源IP以供API网关进行白名单过滤;
11.
外网消费方访问统一使用HTTPS POST请求方式,按照API规范按照附录章节说明进行加验签、加解密。
修改于 2024-04-21 01:42:51
上一页
4.接口调用
下一页
6.更新日志
Built with