3.15 通用附件上传接口

test-测试环境

https://oc-test.onecontract-cloud.com

POST

/api/hitf/v2p/rest/invoke/SFpFUk86T0MtRklMRS1VUExPQUQ6b2MtYmFzZS5oY2JtLXNvdXJjZS1jb250cmFjdC1vcmcub25seVVwbG9hZEZpbGU=

通用的文件上传接口，上传文件后将得到 fileKey，fileKey 可以作为其他接口的参数。

请求参数

Header 参数

Content-Type

string

可选

示例值:

multipart/form-data

Authorization

string

可选

默认值:

Body 参数multipart/form-data

file

文件

必需

示例值:

file:///Users/cyj/Desktop/空白合同.docx

fileName

string

文件名称

必需

示例值:

示例合同.docx

module

enum<string>

文件所属模块

必需

枚举值:

BASETEMPLATE

示例值:

BASE

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2p/rest/invoke/SFpFUk86T0MtRklMRS1VUExPQUQ6b2MtYmFzZS5oY2JtLXNvdXJjZS1jb250cmFjdC1vcmcub25seVVwbG9hZEZpbGU=' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: multipart/form-data' \
--form 'file=@"/Users/cyj/Desktop/空白合同.docx"' \
--form 'fileName="示例合同.docx"' \
--form 'module="BASE"'

返回响应

🟢200成功

application/json

Body

success

boolean

必需

message

string

必需

result

object

必需

errcode

string

必需

errmsg

string

必需

data

string

文件fileKey

必需

示例

成功示例成功示例

{
    "success": true,
    "message": "execute success",
    "result": {
        "errcode": "0",
        "errmsg": "成功",
        "data": "hcbm-contract/contract-file/1273/HUAWEI_CLOUD/2025Y/04M/bb766a1a53a142df9dd31d2ed92422ad@示例合同.docx"
    }
}

3.11 通过fileKey下载文件

3.24 合同列表查询