You will need an API Key ID and API Key Secret to use this API. This API is for retrieving all share records.

HTTPS POST https://svc.digify.com/v1/file/shares/list

  1. Require basic authentications with base64 encoded version of  <Key ID>:<Secret>
  2. List of shared files is returned in reverse chronological order.
  3. Single API call with 2 types of attributes. The first call does not have LastFileGUID and LastFileCreatedTime, which returns the latest share record up to x number of records.
  4. The default value for FilesPerPage is 100 records and the limit for records per page is a total response size of 1 MB.
  5. The response will return LastFileGuid and LastFileCreatedTime which can be used to get the subsequent x number of records.
  6. When the response returns LastFileGuid and LastFileCreatedTime of null value, it signifies that it has reached the end of the list (last page of share records).
  7. FilesPerPage - The number of queried results per response.
  8. LastFileGuid -  Unique identifier of last file from the previous response.
  9. LastFileCreatedTime - Share time of last file from the previous response.

Sample 1st Request 

POST https://svc.digify.com/v1/file/share/list

Host: svc.digify.com
Connection: keep-alive
Accept: application/json, text/plain, */*
Authorization: Basic amFccGVyX1Rdfsdsb1BlcjoxMjM0NTZhYmNkZYY=
Content-Type: application/x-www-form-urlencoded
Accept-Encoding: gzip, deflate, br
Accept-Language: en-US,en;q=0.8,zh-CN;q=0.6,zh-TW;q=0.4

{
  "FilesPerPage": 3
}

Sample 1st Response

HTTP/1.1 200 Successfully retrieved share records
Content-Length: 2016
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
Date: Wed, 23 Oct 2019 03:48:17 GMT

{
  "Files": [
    {
      "Guid": "8d855f6590ca412886de111116d5dd54",
      "Link": "https://digify.com/s/jYVfZQ",
      "FileName": "Secret.png",
      "FileCreatedTime": "2019-10-07T08:18:32.77Z",
      "FileStatus": "Active",
      "TotalViewedCount": 1,
      "Permission": "Public",
      "RequestEmail": false,
      "Recipients": null,
      "RestrictForwarding": false,
      "Download": 0,
      "Print": 0,
      "Secret": false,
      "Watermark": false,
      "Watermark_text": null,
      "Watermark_size": null,
      "Watermark_color": null,
      "MovableWatermark": false,
      "Expiry": "off",
      "DestructSeconds": 0,
      "ExpiryDate": "0001-01-01T00:00:00"
    },
    {
      "Guid": "28da9d00eb4949a8961d478841d5958f",
      "Link": "https://digify.com/s/KNqdAA",
      "FileName": "Restricted.docx",
      "FileCreatedTime": "2019-10-02T07:09:53.42Z",
      "FileStatus": "Inactive",
      "TotalViewedCount": 1,
      "Permission": "Restrict",
      "RequestEmail": false,
      "Recipients": null,
      "RestrictForwarding": true,
      "Download": 0,
      "Print": 0,
      "Secret": false,
      "Watermark": false,
      "Watermark_text": null,
      "Watermark_size": null,
      "Watermark_color": null,
      "MovableWatermark": false,
      "Expiry": "off",
      "DestructSeconds": 0,
      "ExpiryDate": "0001-01-01T00:00:00"
    },
    {
      "Guid": "c3c92ca046f046aba2760195d879f6ec",
      "Link": "https://digify.com/s/w8ksoA",
      "FileName": "Confidential.docx",
      "FileCreatedTime": "2019-10-02T07:04:47.213Z",
      "FileStatus": "Active",
      "TotalViewedCount": 0,
      "Permission": "Public",
      "RequestEmail": false,
      "Recipients": null,
      "RestrictForwarding": false,
      "Download": -1,
      "Print": -1,
      "Secret": false,
      "Watermark": false,
      "Watermark_text": null,
      "Watermark_size": null,
      "Watermark_color": null,
      "MovableWatermark": false,
      "Expiry": "off",
      "DestructSeconds": 0,
      "ExpiryDate": "0001-01-01T00:00:00"
    }
  ],
  "FilesCount": 3,
  "LastFileGuid": "c3c92ca046f046aba2760195d879f6ec",
  "LastFileCreatedTime": "2019-10-02T07:04:47.213Z",
  "Status": {
    "StatusCode": 70000,
    "StatusMessage": "Successfully retrieved share records"
  }
}

Sample Subsequent Requests

POST https://svc.digify.com/v1/file/share/list

Host: svc.digify.com
Connection: keep-alive
Accept: application/json, text/plain, */*
Authorization: Basic amFccGVyX1Rdfsdsb1BlcjoxMjM0NTZhYmNkZYY=
Content-Type: application/x-www-form-urlencoded
Accept-Encoding: gzip, deflate, br
Accept-Language: en-US,en;q=0.8,zh-CN;q=0.6,zh-TW;q=0.4

{
  "FilesPerPage": 1
  "LastFileGuid":"c3c92ca046f046aba2760195d879f6ec"
  "LastFileCreatedTime":"2019-10-02T07:04:47.213Z"  
}

Sample Subsequent Responses

HTTP/1.1 200 Successfully retrieved share records
Content-Length: 751
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
Date: Wed, 23 Oct 2019 03:49:48 GMT

{
  "Files": [
    {
      "Guid": "163cc80a70e240e6a4a93e268eea9486",
      "Link": "https://digify.com/s/jYVfZQ",
      "FileName": "Logo.png",
      "FileCreatedTime": "2019-09-21T10:17:50.411Z",
      "FileStatus": "Active",
      "TotalViewedCount": 1,
      "Permission": "Public",
      "RequestEmail": false,
      "Recipients": null,
      "RestrictForwarding": false,
      "Download": 0,
      "Print": 0,
      "Secret": false,
      "Watermark": false,
      "Watermark_text": null,
      "Watermark_size": null,
      "Watermark_color": null,
      "MovableWatermark": false,
      "Expiry": "off",
      "DestructSeconds": 0,
      "ExpiryDate": "0001-01-01T00:00:00"
    }
  ],
  "FilesCount": 1,
  "LastFileGuid": "163cc80a70e240e6a4a93e268eea9486",
  "LastFileCreatedTime": "2019-09-21T10:17:50.411Z",
  "Status": {
    "StatusCode": 70000,
    "StatusMessage": "Successfully retrieved share records"
  }
}


Did this answer your question?