1. 公共
福鑫-OpenAPI
  • 公共
    • 【公共】模块接入说明
    • 获取token
      GET
  • 实时换汇
    • 【实时换汇】模块接入说明
    • 获取报价
      POST
    • 获取报价(bid\offer 客户视角)
      POST
    • 批量获取报价(bid\offer 客户视角)
      POST
    • 获取报价(bid\offer 机构视角)
      POST
    • 创建实时换汇合约
      POST
    • 手动发起交割
      POST
    • 查询换汇记录
      POST
    • 根据幂等单号查询换汇记录
      POST
  • 挂单换汇
    • 【挂单换汇】模块接入说明
    • 获取报价(同实时换汇获取报价)
      POST
    • 获取报价(bid\offer 客户视角)(同实时换汇)
      POST
    • 创建挂单换汇合约
      POST
    • 修改挂单合约
      POST
    • 取消挂单合约
      POST
    • 查询挂单记录
      POST
    • 根据幂等单号查询换汇记录(请参考实时换汇-根据幂等单号查询换汇记录)
      POST
  • 预约换汇
    • 【预约换汇】模块接入说明
    • 获取交易日历
      POST
    • 获取报价
      POST
    • 获取报价(bid\offer 客户视角)
      POST
    • 获取报价(bid\offer 机构视角)
      POST
    • 创建预约换汇合约
      POST
    • 手动发起交割(请参考实时换汇-手动发起交割)
      POST
    • 查询换汇记录(请参考实时换汇-查询换汇记录)
      POST
    • 获取展期日历
      POST
    • 获取展期报价
      POST
    • 展期
      POST
    • 展期v2
      POST
    • 撤销
      POST
    • 根据幂等单号查询换汇记录(请参考实时换汇-根据幂等单号查询换汇记录)
      POST
  • 账户
    • 账户余额查询
    • 实时换汇额度查询
    • 预约换汇额度查询
    • 查询银行卡接口
    • 账户出金
    • 出入金记录查询
  • 数据模型
    • 未命名数据模型
  1. 公共

【公共】模块接入说明

环境#

沙箱环境：https://sandbox-gateway.pingpongx.com

步骤#

第一步#

在客户信息后台页面点击申请 app_id & app_secret
image.png

第二步#

使用【第一步】获取到的app_id、app_secret作为参数，请求接口文档【公共】-【获取token】接口，得到【access_token】
注：【access_token】是有时效的（默认过期时间为7200秒），所以您需要编写程序定时请求【获取token】接口，以更新【access_token】
参考代码：
注：access_token失效说明
1，接入方使用 appId + appSecret 获取 token，业务请求凭token访问资源
2，每个token有效期2小时，以福鑫生成时间开始计时
3，2小时内，接入方如果刷新获取一个新token2，则前一个token1有效期改为5分钟，即token1有效期5分钟，token2有效期2小时（以福鑫刷新时间开始计时）。如果在token1失效前，又刷新获取一个新token3，则token1立即失效，token2有效期改为5分钟，token3有效期2小时（以福鑫刷新时间开始）
4，无效token访问返回401

请求时序#

image.png

接口qps#

默认给到qps=5

异常码#

成功(0),
系统异常(999),
内部服务异常(500),
参数异常(400),
token失效(401),
业务异常(417),
请求过于频繁(429)

交易时间#

5 X 24h(周一早晨6:00 - 周六早晨5:00)
修改于 2024-11-09 01:47:05
下一页
获取token
Built with