金融行业科技部开发人员接口开发维护手册（执行版）.docxVIP

金融行业科技部开发人员接口开发维护手册（执行版）

第1章接口开发规范

1.1接口命名规范

接口命名应直观反映其功能，避免歧义。例如，transferAccount比doAction更具描述性。采用小写字母和下划线分隔的snake_case风格，符合金融行业主流实践。API版本号建议前置，如v1_getUserBalance，确保向后兼容性。避免使用缩写，除非行业通用（如jwt代表JSONWebToken）。命名应保持一致性，例如createOrder与deleteOrder遵循相同模式。服务端点命名需考虑URL长度限制，通常不超过50字符。

1.2数据格式规范

JSON是金融接口首选格式，因其轻量且易于解析。字段命名需区分大小写，键值对必须完整。示例：

{

account:C123456789,

amount:10000.00,

currency:CNY,

timestamp:1640995200

}

日期格式统一使用ISO8601（如2022-03-15T08:00:00Z），避免本地时区歧义。枚举值需显式定义，例如交易状态PROCESSING/COMPLETED。敏感数据（如卡号）必须加密传输，使用TLS1.3+加密通道。请求体大小建议限制2MB以内，超过时通过分页机制处理。

1.3请求与响应规范

GET请求仅传递参数