Streams a private media file referenced by a record's image/file field. The url is the stored value: privates3://, privatecloudfiles://, OneDriveApi:, SharePointApi:, GoogleDriveApi:, DropboxApi:, or a Box (https://*.box.com/shared/static/...) or Dropbox (https://*.dropbox.com/...?raw=1) link. Box and Dropbox links are fetched only from their own hosts, over HTTPS, with bounded retries and timeouts.
Responses
-
OK - the file's raw bytes with the stored
Content-Type. -
Bad Request - the
urlnames a storage path with a dot segment (./..), aprivatecloudfiles://path with an empty target or a dot segment,?,#or control character, or a connector id (OneDriveApi:,SharePointApi:,GoogleDriveApi:,DropboxApi:) containing a dot segment,?,#or a control character. -
Unauthorized - missing or invalid bearer token.
-
Forbidden - the caller cannot access
profile_id, or aprivates3://url names a bucket outside the server's private media buckets (mediaAWSS3Info.privateMediaBucketplusoldPrivateMediaBucketList), or aprivatecloudfiles://url names a country, region and container outside the server's private Cloud Files locations (mediaPrivateMainServerLocationInfo,mediaPrivateBackupServerLocationInfoplusoldPrivateCloudFilesLocationList), or either names a server other than this one or one inoldServerIdList, or (for a caller without server scope) another profile. -
Not Found - the object does not exist or is empty, or the
urlis not a recognised private media reference. -
Conflict - the profile's cloud-drive connection must be reconnected (reconnect required).
-
Bad Gateway - storage failed for a reason other than a missing object (any other S3 or Cloud Files error), or a Box/Dropbox host failed, timed out, redirected outside the provider, or was still answering 202 after 3 attempts.
curl \
--request GET 'https://api.iformbuilder.com/exzact/api/v80/[servername]/profiles/self/media?url=string' \
--header "Authorization: Bearer {access_token}"
@file
{
"error_message": "string"
}
{
"error_message": "string"
}
{
"error_message": "string"
}
{
"error_message": "string"
}
{
"error_message": "string"
}
{
"error_message": "string"
}