Description

Upload message material files.

Request Specification

HTTP Method: POST + application/json

Request Path: https://${cloud domain}/media/upload/message?thirdTraceId=${Random String}

Request Headers: Refer to Common Parameters

Example (using curl command to upload a media file via FORM):

curl -F "media=@test.jpg" http://open.fxiaoke.com/media/upload/message?corpAccessToken=xxx&corpId=xxx

File restrictions:

• Image files: Max 5MB, supports JPG, PNG, GIF, BMP, JPEG formats (for message sending APIs)

Note: mediaId is reusable. The same mediaId can be used for multiple message sends.

Request Parameters

Parameter	Type	Required	Description
media	Binary	Yes	Binary stream (form-data media file with filename, filelength, content-type, etc.)

Request Example

{
  "media": "hello"
}

Response Parameters

Parameter	Type	Description
traceId	string	Unique request ID
errorDescription	string	Error description
errorMessage	string	Error message
errorCode	Int	Error codes

Response Example

{
  "traceId": "E-O.827xxxxxx",
  "errorDescription": "success",
  "errorMessage": "OK",
  "errorCode": 0
}

Notes

• Do not use the message field in the response for logical judgments, as errorMessage may change.