申请对账文件地址¶

功能说明¶

企业客户申请对账文件地址，地址有效期默认60分钟有效，如果失效请重新申请下载地址；
目前支持的对账文件类型bill_type如下：
- 1.第三方资产日对账文件

接口地址¶

测试环境: https://openapi.guanaitong.tech/bill/applyDownloadUrl
生产环境: https://openapi.guanaitong.com/bill/applyDownloadUrl

HTTP请求方式¶

Method: POST
Content-Type: application/x-www-form-urlencoded

参数说明¶

公有参数

发送请求是必须传入公共参数，详见公共参数
私有参数

参数名称	是否必须	参数类型	长度限制	描述
bill_date	是	string	{6,8}	账期；日对账格式如：yyyyMMdd
bill_type	是	int	{1}	业务类型；1：第三方资产
enterprise_code	否	string	[1,20]	企业编号（集团和运营商必填,企业不填）

请求示例¶

 POST /bill/applyDownloadUrl HTTP/1.1
 Host: openapi.guanaitong.tech
 Content-Type: application/x-www-form-urlencoded
 Cache-Control: no-cache

 access_token=ed7ea86cad31aa2fe4e4fc7183922cc2&sign=b83e4926fd4fa771895fb01a401c235a9825d4d4
 timestamp=1492669228&bill_date=20230508&bill_type=1

返回参数说明¶

参数名称	描述
code	返回码。详见错误代码。
msg	如果错误，返回错误信息。
data	账单数据
data.bill_date	账期，同入参
data.bill_no	账单编号，同一账期中如果存在重新生成的情况，此编号会变更
data.download_url	账单地址，阿里云oss文件下载地址，默认有效期60分钟，过期重新获取

正确返回示例¶

{
    "code": 0,
    "msg": "OK",
    "data": {
        "bill_date": "20230508",
        "download_url": "https://gatbizfile.oss-cn-hangzhou.aliyuncs.com/thirdasset/test/by-days/20230509/20230508_Q28036.xlsx?Expires=1683631375&OSSAccessKeyId=O7ZVL2kkrcQAQ6Xa&Signature=LZzGgSBrqCQY%2BvvdKzC%2Fo1OEqkE%3D",
        "bill_no": "20230509182113"
    }
}

错误返回示例¶

{
    "code": 1000210001,
    "data": null,
    "msg": "timestamp check failed!"
}