资源工坊

获取会话文件上传地址 ​

适用版本>=v7.0.2503b.20250327

接口说明：获取会话文件上传地址

请求说明 ​

请求地址配置域名+/openapi+/v7/chats/resources/upload
请求方法POST
签名方式KSO-1（配置域名+/openapi不参与签名）
权限要求查询和管理会话消息（应用授权） kso.chat_message.readwrite

请求头（Header） ​

Header参数类型是否必填说明
X-Kso-Datestring是RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorizationstring是KSO-1 签名值，详见《签名方法》
Authorizationstring是授权凭证，格式为：Bearer {access_token}

请求体 ​

名称类型是否必填说明
file_sizeint是上传文件的大小
file_namestring是上传文件名称（带后缀） 最大500字符
checksumstring是校验和 （上传文件内容的sha256值）
is_avatarbool否当文件是图片时可用于头像（只支持png、jpeg、gif、svg、tiff格式）

响应体（Response） ​

名称类型说明
storage_keystring用于获取下载地址或者发送消息时填入到对应的资源对象中
upload_entryobject上传请求信息
∟ methodstring上传请求的 http method
∟ urlstring文件上传地址
∟ headersmap<string:string>上传文件请求 header 所需要的信息
∟ paramsmap<string:string>POST上传时需要带入到form-data中的信息

响应体示例 ​

json
{
    "code": 0,
    "data": {
        "storage_key": "DD1AFB29NTlkNzgxZTY4NDcyMGUyNWRhYjkwYTJkMzQwMGVkMTE6d3BzMzpwcml2YXRlLXdwc2ZpbGUyOjA=",
        "upload_entry": {
            "headers": {
                "X-Amz-Content-Sha256": "683f861e0a52e2f657fcaf0dc39e9eed2110921e71422fd0510bba0d2b2a496f"
            },
            "method": "put",
            "params": null,
            "url": "https://10.13.72.41/path3/path4/minio/private-wpsfile2/59d781e684720e25dab90a2d3400ed11?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=uevF00Dg2HdXh4VK%2F20250318%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250318T022031Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host%3Bx-amz-content-sha256&X-Amz-Signature=1db94a33347e79e5021ac6761938cfe12a664a13a0181fdd0c1c5f41d0ea7047"
        }
    },
    "msg": "success"
}