New Zimki Documentation Site Released

Bill Hawes on Mon Jul 23 2007 09:41:02 GMT+0100 (GMT)

We have today released an updated site for the Zimki documentation. The site features a new interface with improved navigation. The documentation is divided into several sections:

Getting Started - a series of articles to help you to get started with Zimki.
Tutorials - a series of step-by-step guides to getting what you need from Zimki.
Knowledge Base - More advanced technical articles to help you make the most of Zimki.
API References - references for the server-side JavaScript API, the external APIs and the libraries.

We are continuing to work hard to extend the content available in the documentation.

As noted on the home page at https://docs.zimki.com, please feel free to submit feedback on this documentation.

Zimki 1.10 released

Bill Hawes on Wed Mar 28 2007 09:00:00 GMT+0100 (GMT)

We've just released version 1.10 of Zimki. As well as fixing a number of bugs, we have made the following changes:

External APIs

zimki.file.publish method removed

We have removed the zimki.file.publish method from the Zimki external API. This is because it created a potential security risk for your realms.

Customer External API

There is a new external API available which allows you to manage your Zimki realms using external tools. The endpoint for this API is at https://www.zimki.com/api. You must authenticate using your registered email address and password.

The API documentation is at https://docs.zimki.com/CustomerExternalAPI.

We plan to release a number of desktop tools that take advantage of this feature in the near future. Watch this space…

JSON return type

Both the Zimki and Customer external APIs can return JSON as an alternative to XML - simply add a "_type=json" parameter to your request. See https://docs.zimki.com/ExternalAPI for more details.

Platform Changes

File implementation

Zimki files are now implemented as persistent instances of class zimki_file, and file publications as persistent instances of class zimki_publish. This means that you can set your own attributes on these instances.

Remote calls

Responses from zimki.remote.* calls now have a 'headers' property containing the response headers.

Portal Changes

Instance searching

There is now a search form on the instances page. You can enter an attribute name, a search clause and a value to search on. Results are paginated and pagination works across search results.

Realm backup

When backing up a realm, the backup file will now be named after your realm name.

Realm cloning

When cloning a realm, you must now identify the source realm by an API Key or API Key alias instead of realm id.

Zimki client library for .NET and mono

Bill Hawes on Fri Oct 27 2006 11:06:52 GMT+0100 (GMT)

We have now released a client library to enable you to access zimki from applications written using the Microsoft .NET Framework for Windows or mono for Linux, Mac, etc.

This gives a simple object-oriented interface, with which you can create, retrieve, update and delete class instances and files in your zimki realm. You can also make any zimki XML API call, including those you have published from your realm.

A c# program to list files in your realm is as simple as:

using System;
using Fotango.Zimki.Client;

class Program
{
    static string url = "http://service.zimki.com/zimki";
    static string apiKey = "my-api-key";
    static string userName = "my-user-name";
    static string password = "my-password";

    public static void Main(string[] args)
    {
        using (ClientSession session = new ClientSession(url, apiKey))
        {
            session.Authenticate(userName, password);
            foreach (File file in session.SearchFiles())
            {
                Console.WriteLine(file.Description);
            }
        }
    }
}

Go to the Zimki.NET home page for more information, including links to downloads, documentation and a brief tutorial.