跳转到主要内容
POST
Initiate File Uploads

授权

X-EntityToken
string
header
必填

This API requires an Entity Session Token, available from the Entity GetEntityToken method.

请求体

application/json

Returns URLs that may be used to upload the files for a profile 5 minutes. After using the upload calls FinalizeFileUploads must be called to move the file status from pending to live.

Returns URLs that may be used to upload the files for a profile 5 minutes. After using the upload calls FinalizeFileUploads must be called to move the file status from pending to live.

Entity
object
必填

The entity to perform this action on.

FileNames
string[]
必填

Names of the files to be set. Restricted to a-Z, 0-9, '(', ')', '_', '-' and '.'

CustomTags
object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ProfileVersion
number

Optional field used for concurrency control. By specifying the previously returned ProfileVersion value from the GetFiles API or other APIs, you can ensure that the file upload initiation is performed only if the profile has not been updated since you last loaded that version. If the profile for the same entity has been updated, the operation will fail with an EntityProfileVersionMismatch error. The conflicting update can be caused by any operation that modifies the entity profile, including SetObjects, FinalizeFileUploads, and UpdateStatistics.

响应

code
integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status
string

The Http status code as a string.

data
object
示例:
最后修改于 2026年10月6日