API REFERENCE GUIDE

CLOUD DATA  data_down

api description

purpose

data_down downloads some data identified by its ID.

Depending on the data sharing code (see data_up), session parameters may be required: uuid, usid, udid and eost. See signin for further details.

When used with subscriber session parameters within an AuverCloud business account, data_down returns the following associative array:

  • data: Stored data.
  • text: Searchable text.
  • count_down: Number of downloads
  • count_up: Number of uploads.
  • created_on: Creation date/time.
  • updated_on: Latest update date/time.
  • share: Sharing code.

If used in anonymous mode (enabled by sharing code 3 or 4), then only data is returned.

http method: POST

call cost: 1 point

See the pricing section for more details.

mandatory parameter(s)

parameter values / comments
api"data_down"
key E.g. "c54e7837e0cd0ced286cb5995327d1ab54e35987179b2". It is an application key generated by AuverCloud Studio.
idA data ID as returned by data_up.

optional parameters(s)

parameter values / comments
uuidUnique User ID.
usidUnique Session ID.
udidUnique Device ID.
eostEnd of Session Time.

call sample

This example is the code used in the test case below. It assumes that jQuery and the JavaScript AuverCloud runtime client are loaded in order to use the arc.api() method. See the API client section for more details.


							

errors

code message comments
645 Unknown data. The data ID is not recognized.
646 Forbidden access. The data has a sharing code which is not compatible with the current API call.

See also the Common errors section.

test bed

Call

To test the API with your own keys, please see the section Application keys in AuverCloud Studio.

api
data_down
key
id
uuid
usid
udid
eost
 send
request
 clear
response
Response
code
msg
data

discussion