Depending on the licence you purchased you are entitled to daily, weekly or monthly updates.
Updating the local copy of the DeviceAtlas database means that you will download and install a copy of the database, while the API should remain untouched. API updates will happen from time to time and will be announced on the site and on mobiForge.com, while updates to the database happen on a daily basis.
You may check updates at any time accessing our website, logging in and clicking on "My Licences" below the tabs on the right-hand side. "My Licences" will only appear if you have purchased at least one licence.
In "My Licences" you will see a table with as many rows the licences you purchased in reverse order by date (the most recent at the top). In the column "CURRENT AVAILABLE DOWNLOAD" you will see a date that tells you the most recent update you are entitled to download a two links called "gzip" and "zip". You may download the update file in one of the two formats.
Some users may prefer to have an automatic update, especially those with a Premium licence that entitles them to daily updates. We have a URL where users may download the latest update they are entitled to, simply providing their licence number. The base URL is https://deviceatlas.com/getJSON.php (non-SSL is also available, just use http instead of https) . In order to get the file you should specify two querystring parameters, "licencekey" and "format". "licencekey" is the 32 character key that you received in your e-mail, the format is either "zip" or "gzip", you are free to pick the one that suits you best. The request should look like this:
https://deviceatlas.com/getJSON.php?licencekey=1234567890&format=zip
If you do not remember the parameters you can simply call getJSON.php and fill a form, copying and pasting your licencekey. You may then copy the URL and use it in your scripts.
If you can't find the e-mail we sent you or you lost your licence key, simply login to our website, access "My Licences" (will only appear if you have purchased at least one licence) and click the licence number in the first column. A new page will load that will display the key.
If you are automating the download and updates you will want to make sure the download was completed properly and that the file is not corrupted.
In order to achieve this we added a parameter called "md5".
By setting this to "1", you will get a text file with the MD5 of the archived JSON (one for the gzip and one for the zip). So, by setting the querystring to ?licencekey=1234567890&format=zip&md5=1 you will get the MD5 for the zip. The same applies with gzip - just change the "format" parameter.
Once you have downloaded the updated database, manually or automatically, what you should do is backup your files and copy the new file to replace the JSON file you already had.
The file you download will have a filename that corresponds to the date it was generated. Ensure you rename the file to use the same filename as referenced in your code.
If you changed the filename in your API calls, please review your code and make sure the filenames are correct. You can review the documentation provided in the packages or our online documentation linked from the Downloads page.
The command to load the JSON database is as follows.
Java:
HashMap tree = Api.getTreeFromFile("sample/DeviceAtlas.json");
.NET:
Hashtable tree = Api.GetTreeFromFile("sample/DeviceAtlas.json");
PHP:
$tree = da_get_tree_from_file("sample/DeviceAtlas.json");
Check out the downloads page and specific API documentation for more help.