Platform API

<back to all web services

ManagePrimaryImage

Requires Authentication
The following routes are available for this service:
All Verbs/api/primaryimage
All Verbs/api/primaryimage/userprofile
ManagePrimaryImage Parameters:
NameParameterData TypeRequiredDescription
ContactIdOwnerqueryGuidYesThe licensee's contact Id linked to the media file.
FilequeryMediaModelYesPrimary image file to be uploaded including file type and content type.
ApplianceIdqueryGuidYesAppliance from which primary image file is to be uploaded.
ContainerNamequeryGuidYesBlob storage container to which primary image file is to be uploaded.
ConnectedObjectIdqueryGuidYesObject for which primary image is to be uploaded.
MediaModel Parameters:
NameParameterData TypeRequiredDescription
MediaFileIdformGuidNo
MediaNameformstringNo
FileContentformstringNo
FileContentTypeformstringNo
FilePathformstringNo
OriginalFileNameformstringNo
ImageWidthformintNo
ImageHeightformintNo
FileSizeKBformintNo
BlobUriRawformstringNo
BlobUriFullformstringNo
BlobUriThumbnailformstringNo
WatermarkUriformstringNo
CapturedDateformDateTimeNo
CapturedByContactIdformGuid?No
CapturedByContactNameformstringNo
CapturedByContactThumbnailUrlformstringNo
NotesformstringNo
ResourceActionNameformstringNo
LocationVerifiedformstringNo
TrafficLightLocationVerifiedformGuidNo
AudienceLevelformstringNo
WorksForformstringNo
SaveMediaResponse Parameters:
NameParameterData TypeRequiredDescription
ErosMediaFileIdqueryGuidNoMedia File Guid
MediaNamequerystringNoMedia File Name
OriginalFileNamequerystringNoThe original name of the media being saved.
MediaFileUrlquerystringNoUrl of the media file.
MediaFileThumbnailUrlquerystringNoUrl of the media file thumbnail.
ResponseStatusqueryResponseStatusNoService Stack Response Status.

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/primaryimage HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"ContactIdOwner":"00000000-0000-0000-0000-000000000000","File":{"MediaFileId":"00000000-0000-0000-0000-000000000000","MediaName":"String","FileContent":"String","FileContentType":"String","FilePath":"String","OriginalFileName":"String","ImageWidth":0,"ImageHeight":0,"FileSizeKB":0,"BlobUriRaw":"String","BlobUriFull":"String","BlobUriThumbnail":"String","WatermarkUri":"String","CapturedDate":"0001-01-01T00:00:00.0000000","CapturedByContactId":"00000000000000000000000000000000","CapturedByContactName":"String","CapturedByContactThumbnailUrl":"String","Notes":"String","ResourceActionName":"String","LocationVerified":"String","TrafficLightLocationVerified":"00000000-0000-0000-0000-000000000000","AudienceLevel":"String","WorksFor":"String"},"ApplianceId":"00000000-0000-0000-0000-000000000000","ContainerName":"String","ConnectedObjectId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"ErosMediaFileId":"00000000-0000-0000-0000-000000000000","MediaName":"String","OriginalFileName":"String","MediaFileUrl":"String","MediaFileThumbnailUrl":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}