Chilkat Online Tools

Xojo / Salesforce Platform APIs / File Shares

Back to Collection Items

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

Dim http As New Chilkat.Http
Dim success As Boolean

// Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = "<access_token>"

Dim sbResponseBody As New Chilkat.StringBuilder
success = http.QuickGetSb("https://domain.com/services/data/v{{version}}/connect/files/:FILE_ID/file-shares",sbResponseBody)
If (success = False) Then
    System.DebugLog(http.LastErrorText)
    Return
End If

Dim jResp As New Chilkat.JsonObject
success = jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

System.DebugLog("Response Body:")
System.DebugLog(jResp.Emit())

Dim respStatusCode As Int32
respStatusCode = http.LastStatus
System.DebugLog("Response Status Code = " + Str(respStatusCode))
If (respStatusCode >= 400) Then
    System.DebugLog("Response Header:")
    System.DebugLog(http.LastHeader)
    System.DebugLog("Failed.")
    Return
End If

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "currentPageUrl": "/services/data/v58.0/connect/files/069.../file-shares",
//   "linkShare": null,
//   "nextPageUrl": null,
//   "previousPageUrl": null,
//   "shares": [
//     {
//       "entity": {
//         "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/7292o000000oAgZ/F",
//           "mediumPhotoUrl": "https://<my_domain>/profilephoto/7292o000000oAgZ/M",
//           "photoVersionId": "729...",
//           "smallPhotoUrl": "https://<my_domain>/profilephoto/7292o000000oAgZ/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"
//       },
//       "sharingType": "I"
//     }
//   ]
// }

// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

Dim AdditionalLabel As String
Dim CommunityNickname As String
Dim CompanyName As String
Dim DisplayName As String
Dim FirstName As String
Dim Id As String
Dim IsActive As Boolean
Dim IsInThisCommunity As Boolean
Dim LastName As String
Dim Color As String
Dim LargeIconUrl As String
Dim MediumIconUrl As String
Dim SmallIconUrl As String
Dim SvgIconUrl As String
Dim MySubscription As String
Dim Name As String
Dim Message As String
Dim FullEmailPhotoUrl As String
Dim LargePhotoUrl As String
Dim MediumPhotoUrl As String
Dim PhotoVersionId As String
Dim SmallPhotoUrl As String
Dim StandardEmailPhotoUrl As String
Dim v_Url As String
Dim Reputation As String
Dim Title As String
Dim v_Type As String
Dim entityUrl As String
Dim UserType As String
Dim sharingType As String

Dim currentPageUrl As String
currentPageUrl = jResp.StringOf("currentPageUrl")
Dim linkShare As String
linkShare = jResp.StringOf("linkShare")
Dim nextPageUrl As String
nextPageUrl = jResp.StringOf("nextPageUrl")
Dim previousPageUrl As String
previousPageUrl = jResp.StringOf("previousPageUrl")
Dim i As Int32
i = 0
Dim count_i As Int32
count_i = jResp.SizeOfArray("shares")
While i < count_i
    jResp.I = i
    AdditionalLabel = jResp.StringOf("shares[i].entity.additionalLabel")
    CommunityNickname = jResp.StringOf("shares[i].entity.communityNickname")
    CompanyName = jResp.StringOf("shares[i].entity.companyName")
    DisplayName = jResp.StringOf("shares[i].entity.displayName")
    FirstName = jResp.StringOf("shares[i].entity.firstName")
    Id = jResp.StringOf("shares[i].entity.id")
    IsActive = jResp.BoolOf("shares[i].entity.isActive")
    IsInThisCommunity = jResp.BoolOf("shares[i].entity.isInThisCommunity")
    LastName = jResp.StringOf("shares[i].entity.lastName")
    Color = jResp.StringOf("shares[i].entity.motif.color")
    LargeIconUrl = jResp.StringOf("shares[i].entity.motif.largeIconUrl")
    MediumIconUrl = jResp.StringOf("shares[i].entity.motif.mediumIconUrl")
    SmallIconUrl = jResp.StringOf("shares[i].entity.motif.smallIconUrl")
    SvgIconUrl = jResp.StringOf("shares[i].entity.motif.svgIconUrl")
    MySubscription = jResp.StringOf("shares[i].entity.mySubscription")
    Name = jResp.StringOf("shares[i].entity.name")
    Message = jResp.StringOf("shares[i].entity.outOfOffice.message")
    FullEmailPhotoUrl = jResp.StringOf("shares[i].entity.photo.fullEmailPhotoUrl")
    LargePhotoUrl = jResp.StringOf("shares[i].entity.photo.largePhotoUrl")
    MediumPhotoUrl = jResp.StringOf("shares[i].entity.photo.mediumPhotoUrl")
    PhotoVersionId = jResp.StringOf("shares[i].entity.photo.photoVersionId")
    SmallPhotoUrl = jResp.StringOf("shares[i].entity.photo.smallPhotoUrl")
    StandardEmailPhotoUrl = jResp.StringOf("shares[i].entity.photo.standardEmailPhotoUrl")
    v_Url = jResp.StringOf("shares[i].entity.photo.url")
    Reputation = jResp.StringOf("shares[i].entity.reputation")
    Title = jResp.StringOf("shares[i].entity.title")
    v_Type = jResp.StringOf("shares[i].entity.type")
    entityUrl = jResp.StringOf("shares[i].entity.url")
    UserType = jResp.StringOf("shares[i].entity.userType")
    sharingType = jResp.StringOf("shares[i].sharingType")
    i = i + 1
Wend

Curl Command

curl -X GET
	-H "Authorization: Bearer <access_token>"
https://domain.com/services/data/v{{version}}/connect/files/:FILE_ID/file-shares

Postman Collection Item JSON

{
  "name": "File Shares",
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "exec": [
          ""
        ],
        "type": "text/javascript"
      }
    },
    {
      "listen": "test",
      "script": {
        "exec": [
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "protocolProfileBehavior": {
    "disabledSystemHeaders": {}
  },
  "request": {
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "{{_endpoint}}/services/data/v{{version}}/connect/files/:FILE_ID/file-shares",
      "host": [
        "{{_endpoint}}"
      ],
      "path": [
        "services",
        "data",
        "v{{version}}",
        "connect",
        "files",
        ":FILE_ID",
        "file-shares"
      ],
      "variable": [
        {
          "key": "FILE_ID",
          "value": ""
        }
      ]
    },
    "description": "Returns information about the objects with which the specified file has been shared. Objects can be users, groups, or records.\n\nhttps://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_files_shares.htm"
  },
  "response": [
    {
      "name": "Successful File Shares",
      "originalRequest": {
        "method": "GET",
        "header": [
        ],
        "url": {
          "raw": "{{_endpoint}}/services/data/v{{version}}/connect/files/:FILE_ID/file-shares",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "connect",
            "files",
            ":FILE_ID",
            "file-shares"
          ],
          "variable": [
            {
              "key": "FILE_ID",
              "value": "0692o00000woaRkAAI"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Date",
          "value": "Mon, 20 Nov 2023 16:37:07 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    \"currentPageUrl\": \"/services/data/v58.0/connect/files/069.../file-shares\",\n    \"linkShare\": null,\n    \"nextPageUrl\": null,\n    \"previousPageUrl\": null,\n    \"shares\": [\n        {\n            \"entity\": {\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/7292o000000oAgZ/F\",\n                    \"mediumPhotoUrl\": \"https://<my_domain>/profilephoto/7292o000000oAgZ/M\",\n                    \"photoVersionId\": \"729...\",\n                    \"smallPhotoUrl\": \"https://<my_domain>/profilephoto/7292o000000oAgZ/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            \"sharingType\": \"I\"\n        }\n    ]\n}"
    }
  ]
}