上传文件

最近更新时间:2019-08-13 19:58:05

1. 接口描述

接口请求域名: cr.ap-shenzhen-fsi.tencentcloudapi.com 。

该接口包含上传下列文件:

  1. 入催文件:用于每天入催文件的上传
  2. 还款文件:实时上传当前已还款客户,用于还款客户的实时停催
  3. 回访文件:用于每天贷中回访文件的上传
  4. 回访停拨文件:实时上传回访停拨名单文件,文件中的名单实时停拨

接口返回数据任务ID,支持xlsx、xls、csv、zip格式,文档大小不超过50MB。

默认接口请求频率限制:2次/秒。

注意:本接口只能使用 POST multipart/form-data 调用。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:UploadDataFile
Version String 公共参数,本接口取值:2018-03-21
Region String 公共参数,本接口取值 ap-shenzhen-fsi。
Module String 模块名,本接口取值:Data
Operation String 操作名,本接口取值:Upload
FileName String 文件名
UploadModel String

上传类型,不填默认催收文件,取值范围:

  • data:入催文件
  • repay:还款文件
  • callback:回访文件
  • callstop:回访停拨文件
File Binary 文件,文件与文件地址上传只可选用一种,必须使用multipart/form-data协议来上传二进制流文件,建议使用xlsx格式,大小不超过5MB。
FileUrl String 文件上传地址,文件与文件地址上传只可选用一种,大小不超过50MB。
InstId String 实例ID,不传默认为系统分配的初始实例。

3. 输出参数

参数名称 类型 描述
DataResId String 数据ID
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 上传催收文件

输入示例

https://cr.ap-shenzhen-fsi.tencentcloudapi.com/?Action=UploadDataFile
&Module=Data
&Operation=Upload
&FileName=data_1542284923873.xlsx
%FileUrl=http://cr.cosgz.myqcloud.com/uploadfile/data_1542284923873.xlsx
&<公共请求参数>

输出示例

{
  "Response": {
    "DataResId": "tad-iccc970kgp",
    "RequestId": "13cb0b60-6e0d-43e2-9123-b9361bf0f93e"
  }
}

示例2 上传还款文件

输入示例

https://cr.ap-shenzhen-fsi.tencentcloudapi.com/?Action=UploadDataFile
&Module=Data
&Operation=Upload
&UploadModel=repay
&FileName=data_1542284924562.xlsx
%FileUrl=http://cr.cosgz.myqcloud.com/uploadfile/data_1542284924562.xlsx
&<公共请求参数>

输出示例

{
  "Response": {
    "DataResId": "tad-qccc310kgp",
    "RequestId": "13cb0b60-1e0d-43e2-9123-b3361bf0f93e"
  }
}

示例3 上传二进制催收文件

输入示例

Host: cr.ap-shenzhen-fsi.tencentcloudapi.com
Method: POST
Header: Content-Type: multipart/form-data; boundary=90736ffad78a4ac299d4211b1a1c8e6c
X-TC-Action: UploadDataFile
X-TC-RequestClient: SDK_PYTHON_3.0.36
X-TC-Timestamp: 1543300000
X-TC-Version: 2018-03-21
X-TC-Region: ap-guangzhou
Authorization: TC3-HMAC-SHA256 Credential=xxx/2018-11-27/cr/tc3_request, SignedHeaders=content-type;host, Signature=yyy
Data: --90736ffad78a4ac299d4211b1a1c8e6c

Content-Disposition: form-data; name="Module"

Data

--90736ffad78a4ac299d4211b1a1c8e6c

Content-Disposition: form-data; name="Operation"

Upload

--90736ffad78a4ac299d4211b1a1c8e6c

Content-Disposition: form-data; name="FileName"

data_1542284923873.xlsx

--90736ffad78a4ac299d4211b1a1c8e6c

Content-Disposition: form-data; name="File"; filename="File"

BinaryData

--90736ffad78a4ac299d4211b1a1c8e6c--

输出示例

{
  "Response": {
    "DataResId": "tad-icfd470kgp",
    "RequestId": "13cb0b60-6e0d-43e2-9123-b936bg40f93e"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.UploadDataError 上传数据出错。
InternalError.UnknownError 内部未知错误。
MissingParameter.MOError 找不到Module 或 Operation。
UnauthorizedOperation.AccountNotFound 账户不存在或未开通催收机器人。