更新时间:2026-04-16 GMT+08:00

数据核对(轧账) - DataVerify

功能介绍

数据核对,运营商从KooDrive官网下载对账导入模板,填充数据后调用此接口进行数据核对。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/reconciliation/data/verify

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

参数解释:

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

x-traceid

String

参数解释:

业务跟踪id(必须58位)

约束限制:

不涉及

取值范围:

长度为58位

默认值:

不涉及

X-Date

String

参数解释:

日期,用于app鉴权

约束限制:

日期格式:yyyyMMDD'T'HHmmss'Z' ; 例如20251103T070140Z

取值范围:

距当前时间15分钟以内,不能晚于当前时间

默认值:

不涉及

X-User-Id

String

参数解释:

KooDrive侧用户id,用于app鉴权

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

表2 FormData参数

参数

是否必选

参数类型

描述

data

File

参数解释:

运营商对账单输入

约束限制:

Excel格式,文件名后缀为xlsx或xls,导入模板在KooDrive官网下载

取值范围:

不涉及

默认值:

不涉及

billingCycle

String

参数解释:

账期

约束限制:

格式 yyyy-mm 例如 2025-09,即为9月账期

取值范围:

过去的账期

默认值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

batchNo

String

本次对账批次号,用于后续查询差异记录

请求示例

数据核对请求

/koodrive/ose/v1/reconciliation/data/verify

data: file
billingCycle: "2025-07"

响应示例

状态码:200

数据核对响应

{
  "code" : 0,
  "msg" : "成功",
  "batchNo" : "1465526652212121"
}

状态码

状态码

描述

200

数据核对响应