Back to Collection Items
var
http: HCkHttp;
success: Boolean;
req: HCkHttpRequest;
resp: HCkHttpResponse;
sbResponseBody: HCkStringBuilder;
jResp: HCkJsonObject;
respStatusCode: Integer;
checksum: PWideChar;
contentHubRepository: PWideChar;
contentModifiedDate: PWideChar;
contentSize: Integer;
contentUrl: PWideChar;
createdDate: PWideChar;
description: PWideChar;
downloadUrl: PWideChar;
externalDocumentUrl: PWideChar;
externalFilePermissionInformation: PWideChar;
fileAsset: PWideChar;
fileExtension: PWideChar;
fileType: PWideChar;
flashRenditionStatus: PWideChar;
id: PWideChar;
isFileAsset: Boolean;
isInMyFileSync: Boolean;
isMajorVersion: Boolean;
mimeType: PWideChar;
moderationFlags: PWideChar;
modifiedDate: PWideChar;
Color: PWideChar;
LargeIconUrl: PWideChar;
MediumIconUrl: PWideChar;
SmallIconUrl: PWideChar;
SvgIconUrl: PWideChar;
mySubscription: PWideChar;
name: PWideChar;
origin: PWideChar;
AdditionalLabel: PWideChar;
CommunityNickname: PWideChar;
CompanyName: PWideChar;
DisplayName: PWideChar;
FirstName: PWideChar;
Id: PWideChar;
IsActive: Boolean;
IsInThisCommunity: Boolean;
LastName: PWideChar;
MotifColor: PWideChar;
MotifLargeIconUrl: PWideChar;
MotifMediumIconUrl: PWideChar;
MotifSmallIconUrl: PWideChar;
MotifSvgIconUrl: PWideChar;
MySubscription: PWideChar;
Name: PWideChar;
Message: PWideChar;
FullEmailPhotoUrl: PWideChar;
LargePhotoUrl: PWideChar;
MediumPhotoUrl: PWideChar;
PhotoVersionId: PWideChar;
SmallPhotoUrl: PWideChar;
StandardEmailPhotoUrl: PWideChar;
v_Url: PWideChar;
Reputation: PWideChar;
Title: PWideChar;
v_Type: PWideChar;
ownerUrl: PWideChar;
UserType: PWideChar;
pageCount: Integer;
parentFolder: PWideChar;
pdfRenditionStatus: PWideChar;
publishStatus: PWideChar;
renditionUrl: PWideChar;
renditionUrl240By180: PWideChar;
renditionUrl720By480: PWideChar;
repositoryFileId: PWideChar;
repositoryFileUrl: PWideChar;
sharingOption: PWideChar;
sharingPrivacy: PWideChar;
sharingRole: PWideChar;
systemModstamp: PWideChar;
textPreview: PWideChar;
thumb120By90RenditionStatus: PWideChar;
thumb240By180RenditionStatus: PWideChar;
thumb720By480RenditionStatus: PWideChar;
title: PWideChar;
CurrentPageUrl: PWideChar;
NextPageUrl: PWideChar;
v_type: PWideChar;
url: PWideChar;
versionNumber: PWideChar;
i: Integer;
count_i: Integer;
begin
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
http := CkHttp_Create();
req := CkHttpRequest_Create();
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putPath(req,'/services/data/v{{version}}/connect/files/users/me');
CkHttpRequest_putContentType(req,'multipart/form-data');
success := CkHttpRequest_AddFileForUpload2(req,'fileData',' path to file','application/octet-stream');
CkHttpRequest_AddHeader(req,'Authorization','Bearer <access_token>');
CkHttpRequest_AddHeader(req,'Expect','100-continue');
resp := CkHttp_SynchronousRequest(http,'domain.com',443,True,req);
if (CkHttp_getLastMethodSuccess(http) = False) then
begin
Memo1.Lines.Add(CkHttp__lastErrorText(http));
Exit;
end;
sbResponseBody := CkStringBuilder_Create();
CkHttpResponse_GetBodySb(resp,sbResponseBody);
jResp := CkJsonObject_Create();
CkJsonObject_LoadSb(jResp,sbResponseBody);
CkJsonObject_putEmitCompact(jResp,False);
Memo1.Lines.Add('Response Body:');
Memo1.Lines.Add(CkJsonObject__emit(jResp));
respStatusCode := CkHttpResponse_getStatusCode(resp);
Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
if (respStatusCode >= 400) then
begin
Memo1.Lines.Add('Response Header:');
Memo1.Lines.Add(CkHttpResponse__header(resp));
Memo1.Lines.Add('Failed.');
CkHttpResponse_Dispose(resp);
Exit;
end;
CkHttpResponse_Dispose(resp);
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "checksum": "71a50dbba44c78128b221b7df7bb51f1",
// "contentHubRepository": null,
// "contentModifiedDate": "2023-11-20T16:28:22.000Z",
// "contentSize": 95,
// "contentUrl": null,
// "createdDate": "2023-11-20T16:28:22.000Z",
// "description": null,
// "downloadUrl": "/services/data/v58.0/connect/files/069.../content?versionNumber=1",
// "externalDocumentUrl": null,
// "externalFilePermissionInformation": null,
// "fileAsset": null,
// "fileExtension": "png",
// "fileType": "Png",
// "flashRenditionStatus": "Na",
// "id": "069...",
// "isFileAsset": false,
// "isInMyFileSync": false,
// "isMajorVersion": true,
// "mimeType": "image/png",
// "moderationFlags": null,
// "modifiedDate": "2023-11-20T16:28:22.000Z",
// "motif": {
// "color": "939393",
// "largeIconUrl": "/img/content/content64.png",
// "mediumIconUrl": "/img/content/content32.png",
// "smallIconUrl": "/img/icon/files16.png",
// "svgIconUrl": null
// },
// "mySubscription": null,
// "name": "1x1.png",
// "origin": "Chatter",
// "owner": {
// "additionalLabel": null,
// "communityNickname": "User1696423780773910041",
// "companyName": "Salesforce",
// "displayName": "Name",
// "firstName": "Firstname",
// "id": "005...",
// "isActive": true,
// "isInThisCommunity": true,
// "lastName": "Name",
// "motif": {
// "color": "1B96FF",
// "largeIconUrl": "/img/icon/profile64.png",
// "mediumIconUrl": "/img/icon/profile32.png",
// "smallIconUrl": "/img/icon/profile16.png",
// "svgIconUrl": null
// },
// "mySubscription": null,
// "name": "Name",
// "outOfOffice": {
// "message": ""
// },
// "photo": {
// "fullEmailPhotoUrl": "https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0IogXzXAXaYKJnuWCNQmXymRq?fromEmail=1",
// "largePhotoUrl": "https://<my_domain>/profilephoto/729.../F",
// "mediumPhotoUrl": "https://<my_domain>/profilephoto/729.../M",
// "photoVersionId": "729...",
// "smallPhotoUrl": "https://<my_domain>/profilephoto/729.../T",
// "standardEmailPhotoUrl": "https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0Ioi-dtynkoFWsl46as__TDFU?fromEmail=1",
// "url": "/services/data/v58.0/connect/user-profiles/005.../photo"
// },
// "reputation": null,
// "title": null,
// "type": "User",
// "url": "/services/data/v58.0/chatter/users/005...",
// "userType": "Internal"
// },
// "pageCount": 0,
// "parentFolder": null,
// "pdfRenditionStatus": "Na",
// "publishStatus": "PrivateAccess",
// "renditionUrl": "/services/data/v58.0/connect/files/069.../rendition?type=THUMB120BY90",
// "renditionUrl240By180": "/services/data/v58.0/connect/files/069.../rendition?type=THUMB240BY180",
// "renditionUrl720By480": "/services/data/v58.0/connect/files/069.../rendition?type=THUMB720BY480",
// "repositoryFileId": null,
// "repositoryFileUrl": null,
// "sharingOption": "Allowed",
// "sharingPrivacy": "None",
// "sharingRole": "Owner",
// "systemModstamp": "2023-11-20T16:28:23.000Z",
// "textPreview": null,
// "thumb120By90RenditionStatus": "NotScheduled",
// "thumb240By180RenditionStatus": "NotScheduled",
// "thumb720By480RenditionStatus": "NotScheduled",
// "title": "1x1.png",
// "topics": {
// "currentPageUrl": null,
// "nextPageUrl": null,
// "topics": [
// ]
// },
// "type": "File",
// "url": "/services/data/v58.0/connect/files/069...?versionNumber=1",
// "versionNumber": "1"
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
checksum := CkJsonObject__stringOf(jResp,'checksum');
contentHubRepository := CkJsonObject__stringOf(jResp,'contentHubRepository');
contentModifiedDate := CkJsonObject__stringOf(jResp,'contentModifiedDate');
contentSize := CkJsonObject_IntOf(jResp,'contentSize');
contentUrl := CkJsonObject__stringOf(jResp,'contentUrl');
createdDate := CkJsonObject__stringOf(jResp,'createdDate');
description := CkJsonObject__stringOf(jResp,'description');
downloadUrl := CkJsonObject__stringOf(jResp,'downloadUrl');
externalDocumentUrl := CkJsonObject__stringOf(jResp,'externalDocumentUrl');
externalFilePermissionInformation := CkJsonObject__stringOf(jResp,'externalFilePermissionInformation');
fileAsset := CkJsonObject__stringOf(jResp,'fileAsset');
fileExtension := CkJsonObject__stringOf(jResp,'fileExtension');
fileType := CkJsonObject__stringOf(jResp,'fileType');
flashRenditionStatus := CkJsonObject__stringOf(jResp,'flashRenditionStatus');
id := CkJsonObject__stringOf(jResp,'id');
isFileAsset := CkJsonObject_BoolOf(jResp,'isFileAsset');
isInMyFileSync := CkJsonObject_BoolOf(jResp,'isInMyFileSync');
isMajorVersion := CkJsonObject_BoolOf(jResp,'isMajorVersion');
mimeType := CkJsonObject__stringOf(jResp,'mimeType');
moderationFlags := CkJsonObject__stringOf(jResp,'moderationFlags');
modifiedDate := CkJsonObject__stringOf(jResp,'modifiedDate');
Color := CkJsonObject__stringOf(jResp,'motif.color');
LargeIconUrl := CkJsonObject__stringOf(jResp,'motif.largeIconUrl');
MediumIconUrl := CkJsonObject__stringOf(jResp,'motif.mediumIconUrl');
SmallIconUrl := CkJsonObject__stringOf(jResp,'motif.smallIconUrl');
SvgIconUrl := CkJsonObject__stringOf(jResp,'motif.svgIconUrl');
mySubscription := CkJsonObject__stringOf(jResp,'mySubscription');
name := CkJsonObject__stringOf(jResp,'name');
origin := CkJsonObject__stringOf(jResp,'origin');
AdditionalLabel := CkJsonObject__stringOf(jResp,'owner.additionalLabel');
CommunityNickname := CkJsonObject__stringOf(jResp,'owner.communityNickname');
CompanyName := CkJsonObject__stringOf(jResp,'owner.companyName');
DisplayName := CkJsonObject__stringOf(jResp,'owner.displayName');
FirstName := CkJsonObject__stringOf(jResp,'owner.firstName');
Id := CkJsonObject__stringOf(jResp,'owner.id');
IsActive := CkJsonObject_BoolOf(jResp,'owner.isActive');
IsInThisCommunity := CkJsonObject_BoolOf(jResp,'owner.isInThisCommunity');
LastName := CkJsonObject__stringOf(jResp,'owner.lastName');
MotifColor := CkJsonObject__stringOf(jResp,'owner.motif.color');
MotifLargeIconUrl := CkJsonObject__stringOf(jResp,'owner.motif.largeIconUrl');
MotifMediumIconUrl := CkJsonObject__stringOf(jResp,'owner.motif.mediumIconUrl');
MotifSmallIconUrl := CkJsonObject__stringOf(jResp,'owner.motif.smallIconUrl');
MotifSvgIconUrl := CkJsonObject__stringOf(jResp,'owner.motif.svgIconUrl');
MySubscription := CkJsonObject__stringOf(jResp,'owner.mySubscription');
Name := CkJsonObject__stringOf(jResp,'owner.name');
Message := CkJsonObject__stringOf(jResp,'owner.outOfOffice.message');
FullEmailPhotoUrl := CkJsonObject__stringOf(jResp,'owner.photo.fullEmailPhotoUrl');
LargePhotoUrl := CkJsonObject__stringOf(jResp,'owner.photo.largePhotoUrl');
MediumPhotoUrl := CkJsonObject__stringOf(jResp,'owner.photo.mediumPhotoUrl');
PhotoVersionId := CkJsonObject__stringOf(jResp,'owner.photo.photoVersionId');
SmallPhotoUrl := CkJsonObject__stringOf(jResp,'owner.photo.smallPhotoUrl');
StandardEmailPhotoUrl := CkJsonObject__stringOf(jResp,'owner.photo.standardEmailPhotoUrl');
v_Url := CkJsonObject__stringOf(jResp,'owner.photo.url');
Reputation := CkJsonObject__stringOf(jResp,'owner.reputation');
Title := CkJsonObject__stringOf(jResp,'owner.title');
v_Type := CkJsonObject__stringOf(jResp,'owner.type');
ownerUrl := CkJsonObject__stringOf(jResp,'owner.url');
UserType := CkJsonObject__stringOf(jResp,'owner.userType');
pageCount := CkJsonObject_IntOf(jResp,'pageCount');
parentFolder := CkJsonObject__stringOf(jResp,'parentFolder');
pdfRenditionStatus := CkJsonObject__stringOf(jResp,'pdfRenditionStatus');
publishStatus := CkJsonObject__stringOf(jResp,'publishStatus');
renditionUrl := CkJsonObject__stringOf(jResp,'renditionUrl');
renditionUrl240By180 := CkJsonObject__stringOf(jResp,'renditionUrl240By180');
renditionUrl720By480 := CkJsonObject__stringOf(jResp,'renditionUrl720By480');
repositoryFileId := CkJsonObject__stringOf(jResp,'repositoryFileId');
repositoryFileUrl := CkJsonObject__stringOf(jResp,'repositoryFileUrl');
sharingOption := CkJsonObject__stringOf(jResp,'sharingOption');
sharingPrivacy := CkJsonObject__stringOf(jResp,'sharingPrivacy');
sharingRole := CkJsonObject__stringOf(jResp,'sharingRole');
systemModstamp := CkJsonObject__stringOf(jResp,'systemModstamp');
textPreview := CkJsonObject__stringOf(jResp,'textPreview');
thumb120By90RenditionStatus := CkJsonObject__stringOf(jResp,'thumb120By90RenditionStatus');
thumb240By180RenditionStatus := CkJsonObject__stringOf(jResp,'thumb240By180RenditionStatus');
thumb720By480RenditionStatus := CkJsonObject__stringOf(jResp,'thumb720By480RenditionStatus');
title := CkJsonObject__stringOf(jResp,'title');
CurrentPageUrl := CkJsonObject__stringOf(jResp,'topics.currentPageUrl');
NextPageUrl := CkJsonObject__stringOf(jResp,'topics.nextPageUrl');
v_type := CkJsonObject__stringOf(jResp,'type');
url := CkJsonObject__stringOf(jResp,'url');
versionNumber := CkJsonObject__stringOf(jResp,'versionNumber');
i := 0;
count_i := CkJsonObject_SizeOfArray(jResp,'topics.topics');
while i < count_i do
begin
CkJsonObject_putI(jResp,i);
i := i + 1;
end;
CkHttp_Dispose(http);
CkHttpRequest_Dispose(req);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jResp);
Curl Command
curl -X POST
-H "Authorization: Bearer <access_token>"
--form 'fileData=@"/path/to/file"'
https://domain.com/services/data/v{{version}}/connect/files/users/me
Postman Collection Item JSON
{
"name": "Users Files, General",
"event": [
{
"listen": "prerequest",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
},
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"protocolProfileBehavior": {
"disabledSystemHeaders": {}
},
"request": {
"method": "POST",
"header": [
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "fileData",
"type": "file",
"src": [
]
}
]
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/files/users/me",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"files",
"users",
"me"
]
},
"description": "Upload a file, including references to external files, to the Files home or get information about files a user owns. These files don’t include files shared with a user, files a user follows, or general organization files.\nWhen you upload a file to the Files home, it is private and available only to the file owner.\n\nTo upload a file, send it in a multipart/form-data request. You can include the description and title of the file in the multipart/form-data request as a JSON or XML request body. You can also send the information as request parameters. For information about how to create the multipart/form-data message, see Uploading Binary Files.\nhttps://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_users_files_general.htm"
},
"response": [
{
"name": "Successful Users Files, General",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "fileData",
"type": "file",
"src": "/Users/scolladon/Downloads/1x1.png"
}
]
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/files/users/me",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"files",
"users",
"me"
]
}
},
"status": "Created",
"code": 201,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Date",
"value": "Mon, 20 Nov 2023 16:28:22 GMT"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=63072000; includeSubDomains"
},
{
"key": "X-Content-Type-Options",
"value": "nosniff"
},
{
"key": "X-XSS-Protection",
"value": "1; mode=block"
},
{
"key": "X-Robots-Tag",
"value": "none"
},
{
"key": "Cache-Control",
"value": "no-cache,must-revalidate,max-age=0,no-store,private"
},
{
"key": "Content-Type",
"value": "application/json;charset=UTF-8"
},
{
"key": "Vary",
"value": "Accept-Encoding"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
}
],
"cookie": [
],
"body": "{\n \"checksum\": \"71a50dbba44c78128b221b7df7bb51f1\",\n \"contentHubRepository\": null,\n \"contentModifiedDate\": \"2023-11-20T16:28:22.000Z\",\n \"contentSize\": 95,\n \"contentUrl\": null,\n \"createdDate\": \"2023-11-20T16:28:22.000Z\",\n \"description\": null,\n \"downloadUrl\": \"/services/data/v58.0/connect/files/069.../content?versionNumber=1\",\n \"externalDocumentUrl\": null,\n \"externalFilePermissionInformation\": null,\n \"fileAsset\": null,\n \"fileExtension\": \"png\",\n \"fileType\": \"Png\",\n \"flashRenditionStatus\": \"Na\",\n \"id\": \"069...\",\n \"isFileAsset\": false,\n \"isInMyFileSync\": false,\n \"isMajorVersion\": true,\n \"mimeType\": \"image/png\",\n \"moderationFlags\": null,\n \"modifiedDate\": \"2023-11-20T16:28:22.000Z\",\n \"motif\": {\n \"color\": \"939393\",\n \"largeIconUrl\": \"/img/content/content64.png\",\n \"mediumIconUrl\": \"/img/content/content32.png\",\n \"smallIconUrl\": \"/img/icon/files16.png\",\n \"svgIconUrl\": null\n },\n \"mySubscription\": null,\n \"name\": \"1x1.png\",\n \"origin\": \"Chatter\",\n \"owner\": {\n \"additionalLabel\": null,\n \"communityNickname\": \"User1696423780773910041\",\n \"companyName\": \"Salesforce\",\n \"displayName\": \"Name\",\n \"firstName\": \"Firstname\",\n \"id\": \"005...\",\n \"isActive\": true,\n \"isInThisCommunity\": true,\n \"lastName\": \"Name\",\n \"motif\": {\n \"color\": \"1B96FF\",\n \"largeIconUrl\": \"/img/icon/profile64.png\",\n \"mediumIconUrl\": \"/img/icon/profile32.png\",\n \"smallIconUrl\": \"/img/icon/profile16.png\",\n \"svgIconUrl\": null\n },\n \"mySubscription\": null,\n \"name\": \"Name\",\n \"outOfOffice\": {\n \"message\": \"\"\n },\n \"photo\": {\n \"fullEmailPhotoUrl\": \"https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0IogXzXAXaYKJnuWCNQmXymRq?fromEmail=1\",\n \"largePhotoUrl\": \"https://<my_domain>/profilephoto/729.../F\",\n \"mediumPhotoUrl\": \"https://<my_domain>/profilephoto/729.../M\",\n \"photoVersionId\": \"729...\",\n \"smallPhotoUrl\": \"https://<my_domain>/profilephoto/729.../T\",\n \"standardEmailPhotoUrl\": \"https://<my_domain>/ncsphoto/1wsMlOd3tVC7boygqBO8wMT9KzA0D6tqzpbs-Uw0Ioi-dtynkoFWsl46as__TDFU?fromEmail=1\",\n \"url\": \"/services/data/v58.0/connect/user-profiles/005.../photo\"\n },\n \"reputation\": null,\n \"title\": null,\n \"type\": \"User\",\n \"url\": \"/services/data/v58.0/chatter/users/005...\",\n \"userType\": \"Internal\"\n },\n \"pageCount\": 0,\n \"parentFolder\": null,\n \"pdfRenditionStatus\": \"Na\",\n \"publishStatus\": \"PrivateAccess\",\n \"renditionUrl\": \"/services/data/v58.0/connect/files/069.../rendition?type=THUMB120BY90\",\n \"renditionUrl240By180\": \"/services/data/v58.0/connect/files/069.../rendition?type=THUMB240BY180\",\n \"renditionUrl720By480\": \"/services/data/v58.0/connect/files/069.../rendition?type=THUMB720BY480\",\n \"repositoryFileId\": null,\n \"repositoryFileUrl\": null,\n \"sharingOption\": \"Allowed\",\n \"sharingPrivacy\": \"None\",\n \"sharingRole\": \"Owner\",\n \"systemModstamp\": \"2023-11-20T16:28:23.000Z\",\n \"textPreview\": null,\n \"thumb120By90RenditionStatus\": \"NotScheduled\",\n \"thumb240By180RenditionStatus\": \"NotScheduled\",\n \"thumb720By480RenditionStatus\": \"NotScheduled\",\n \"title\": \"1x1.png\",\n \"topics\": {\n \"currentPageUrl\": null,\n \"nextPageUrl\": null,\n \"topics\": []\n },\n \"type\": \"File\",\n \"url\": \"/services/data/v58.0/connect/files/069...?versionNumber=1\",\n \"versionNumber\": \"1\"\n}"
}
]
}
