客户文件上传 - 探马OpenAPI

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数multipart/form-data

userId

必需

销售用户的企微userId（注：当前userId需为此客户的负责人，否则登录系统后，查询不到客户下的上传文件）

示例值:

admin_tmqf0109

customerId

可选

探马存储的的客户id

示例值:

440031506782272

externalUserId

可选

企微客户id（与 customerId，必须存在一个不可全部为null，若都存在，以当前字段为主进行查询）

file

要上传的文件

必需

示例值:

请选择上传文件

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/v3/customer/file-upload' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--form 'userId="admin_tmqf0109"' \
--form 'file=@"请选择上传文件"'

返回响应

🟢200成功

application/json

Body

code

integer

返回码 0.成功

必需

示例：0

message

string

返回描述

必需

示例：success

data

object

返回数据

必需

示例：-

size

string

文件大小

必需

示例：28.8KB

name

string

文件名称（简称）

必需

示例：rBHDtmGwpeqAEwthAABzHRoI_lg99

type

string

文件格式

必需

示例：xlsx

originalFilename

string

文件全名

必需

示例：rBHDtmGwpeqAEwthAABzHRoI_lg99.xlsx

url

string

文件地址

必需

示例：https://dev.tanmarket.cn/fdfsServer/group1/M00/24/5E/rBHDtmG29YiANmQoAABzHUV9rO896.xlsx

fileId

string

文件id

必需

示例：group1/M00/24/5E/rBHDtmG29YiANmQoAABzHUV9rO896.xlsx

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "size": "28.8KB",
        "name": "rBHDtmGwpeqAEwthAABzHRoI_lg99",
        "type": "xlsx",
        "originalFilename": "rBHDtmGwpeqAEwthAABzHRoI_lg99.xlsx",
        "url": "https://dev.tanmarket.cn/fdfsServer/group1/M00/24/5E/rBHDtmG29YiANmQoAABzHUV9rO896.xlsx",
        "fileId": "group1/M00/24/5E/rBHDtmG29YiANmQoAABzHUV9rO896.xlsx"
    }
}