文件上传

• 描述
• 使用须知
• 名词解释
• 接口URL
• 请求参数
• 请求示例
• 响应参数
• 响应数据样例

描述

在指定表单中通过url上传文件，返回文件信息，返回的信息直接用于创建和修改接口填写在附件或图片控件值中

使用须知

开发前，请仔细阅读开发指南。

• POST请求头

{"Authorization": "Bearer YOUR_APIKEY"}

• YOUR_APIKEY请阅读开发指南了解。

名词解释

名称	说明
app_id	应用ID
entry_id	该应用内的表单ID

app_id+entry_id表示全局唯一的表单标识，前往开放平台中的API文档进行查看。

接口URL

POST - /openapi/v1/app/{app_id}/entry/{entry_id}/upload_file

请求参数

参数名	示例值	参数类型	是否必填	参数描述
url	https://xxx.xxxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz	String	是	文件链接，需要能访问到的正确链接地址
name	123.jpg	String	否	文件名称

请求示例

[
    {
        "name": "123.jpg",
        "url": "https://xxx.xxxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
    },
    {
        "name": "456.jpg",
        "url": "https://xxx.xxxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
    }
]

响应参数

参数名	示例值	参数类型	参数描述
data	-	Object	返回数据内容
data.name	123.jpg	String	文件名称
data.size	68065	String	文件大小
data.mime	image/jpeg	String	文件类型
data.url	https://xxx.xxxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz	String	文件下载链接

响应数据样例

{
    "data": [
        {
            "name": "123.jpg",
            "size": 68065,
            "mime": "image/jpeg",
            "url": "https://xxx.xxxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
        },
        {
            "name": "456.jpg",
            "size": 68065,
            "mime": "image/jpeg",
            "url": "https://xxx.xxxxxx.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
        }
    ]
}