Overview
Error Handling

Methods

API Documentation (API Version bleed)

SecureDatashare/

Description

Methods for working with secure datashares

create

URL:

https://api.liquidweb.com/bleed/SecureDatashare/create

Description:

Creates a secure datashare

Parameters:

ParameterTypeNotes
descriptionA string of text, containing no newlines or other control characters.
duration

A positive integer value (i.e. 1 and up).

Desired duration of time before the secure datashare expires (in seconds). Ignored if the "expiration" field is populated.

expirationA valid date and time in YYYY-MM-DD HH:MM:SS format, or a DateTime object.
secretA string permitting tabs, carriage returns and newlines* Required
ticketEither: a valid identifier for a Salesforce Case; or a positive integer value (i.e. 1 and up).; or a positive integer value (i.e. 1 and up), potentially with leading zeros.
views

A positive integer value (i.e. 1 and up).

Total number of times the secure datashare can be viewed

* Optional
  • Defaults to: 1

Returns:

FieldType
accntA valid account number, up to 6 digits in length.
expirationA valid date and time in YYYY-MM-DD HH:MM:SS format, or a DateTime object.
expiredA boolean value (0 or 1).
idA valid id number (a positive integer).
labelA string of text, containing no newlines or other control characters.
remaining_viewsA positive integer value (i.e. 1 and up).
view_countA non-negative integer value (i.e. 0 and up).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

expire

URL:

https://api.liquidweb.com/bleed/SecureDatashare/expire

Description:

Marks the secret as expired and removes its contents from the database

Parameters:

ParameterTypeNotes
idA positive integer value (i.e. 1 and up).* Required

Returns:

FieldType
successA boolean value (0 or 1).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

list

URL:

https://api.liquidweb.com/bleed/SecureDatashare/list

Description:

Returns details for all secure datashares for a given account

Parameters:

ParameterTypeNotes
alsowithAn array of One of: 'added_date', 'caseIDs', 'creator_ip', 'description', 'removed_date', 'secretLogs', 'ticketNumbers', 'viewCount'
case_idA valid identifier for a Salesforce Case
expiredA boolean value (0 or 1).
order_byAn associative array containing the fields:
 
fieldOne of: 'accnt', 'id', 'label'* Optional
  • Defaults to: id
sortOne of: 'asc', 'desc'* Optional
  • Defaults to: desc
page_numA positive integer value (i.e. 1 and up).* Optional
  • Defaults to: 1
page_sizeA positive integer value (i.e. 1 and up).* Optional
  • Defaults to: 25

Returns:

FieldType
item_countA non-negative integer value (i.e. 0 and up).
item_totalA non-negative integer value (i.e. 0 and up).
itemsAn array of associative arrays containing
 
accntA valid account number, up to 6 digits in length.
expirationA valid date and time in YYYY-MM-DD HH:MM:SS format, or a DateTime object.
expiredA boolean value (0 or 1).
idA positive integer value (i.e. 1 and up).
labelA string of text, containing no newlines or other control characters.
remaining_viewsA non-negative integer value (i.e. 0 and up).
view_countA non-negative integer value (i.e. 0 and up).
page_numA positive integer value (i.e. 1 and up).
page_sizeA positive integer value (i.e. 1 and up).
page_totalA positive integer value (i.e. 1 and up).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

read

URL:

https://api.liquidweb.com/bleed/SecureDatashare/read

Description:

Returns the decoded secret. If the secure datashare has been viewed the maximum amount of times, the secret will also be removed from the DB.

Parameters:

ParameterTypeNotes
idA positive integer value (i.e. 1 and up).* Required

Returns:

FieldType
secretA string permitting tabs, carriage returns and newlines

Possible Errors:

Refer to the Error Handling documentation for the list of exception types