The following tips are designed to guide application developers in the best ways to take advantage of the Personal Cloud Storage APIs.
Attention!
If you use an SDK, the access token is automatically refreshed by the SDK. If you allow the refresh token to expire however, the user will have to re-authorize your application in order for your app to regain access. For mobile-only apps this might be the expected behavior. For some server-side apps that run autonomously however, the app may need to refresh tokens automatically before the 14-day period is up in order to maintain access.
It is important to test that your app handles an expired refresh tokens correctly. It is possible to simulate an expired refresh token without waiting 14 days. To do so, visit www.myverizon.com and log in. Go to Services and select My Cloud Media and Contacts, then Settings and Manage App Permissions. Click Remove next to your app to remove your access and refresh tokens.
Attention!
If your application allows the use of multiple devices or platforms with the same application ID, you must ensure that each device or platform receives its own refresh token. To do that, use a device ID as a differentiator during the authentication flow. The device IDs you choose should be unique and constant for each device or platform.
If you do not use the device ID as a differentiator during the authentication flow, and one device or platform uses the shared refresh token to obtain a new access token, the other devices’ or platforms’ refresh tokens will expire and they will not be able to refresh.
Device ID can also be necessary during application development, in cases where user IDs are shared between developers.
There are three different methods that you can use to retrieve the metadata for files or folders. Each method has a different set of advantages and disadvantages described below.
GET /fullview
API returns the metadata for all files and folders within a specified virtual folder.
Advantages
Disadvantages
GET /metadata
API returns the metadata for a single file or folder. For folders, it includes the metadata of the contents of the folder.
Advantages
Disadvantages
modifiedDate
parameter. This approach however, does not display information on deleted files or folders.GET /search
returns the metadata for a list of files or folders that match a specific query.
Advantages
Disadvantages
modifiedDate
parameter. This approach however, does not display information on deleted files or folders.You can specify the thumbnail size in two different ways:
th
(thumbnail height) and tw
(thumbnail width) parameterssize
parameter with possible values of xs
, s
, m
, and l
What you should consider:
th
& tw
parameters can be significantly slower than using the size
parameter.th
& tw
options are appropriate if you are requesting a single thumbnail.size
to specify a preconfigured thumbnail size.Copyright © 2015-2017, Verizon and/or its Licensors. All rights reserved.