The Tale API

Build Status codecov pub package

This is an unofficial way to create a basic API for the ZPG


There are two classes to use TheTaleApi and TheTaleApiWrapper. The only difference between these two are that TheTaleApiWrapper handles the session storing using SessionStorage.

If you don't want any code to handle the session stuff, just use TheTaleApi.

To create TheTaleApiWrapper use the WrapperBuilder.

final wrapper = WrapperBuilder().build(apiUrl, applicationId, appVersion);

You have to set the SessionStorage to make sure the session with preserve between method calls. There is no SessionStorage implementations available, a basic in-memory example would look like this:

class LocalSessionStorage implements SessionStorage {
  SessionInfo _sessionInfo;

  Future<void> addSession(SessionInfo sessionInfo) async {
    _sessionInfo = sessionInfo;

  Future<SessionInfo> readSession() async {
    return _sessionInfo;

  Future<void> updateSession(SessionInfo sessionInfo) async {
    _sessionInfo = sessionInfo;


Only a few methods will actually set the session: apiInfo() and authStatus(). This means that the session will be empty if you don't call apiInfo() before any other call.

Please, refer to the example for more details.