Mambu Java Client repository is archived

Please be aware that the Mambu Java Client repository has been archived because is not maintained anymore, it won't benefit by latest updates in terms of functionality and security patches. Repository will become read-only together will all pull requests. The only source of documentation and specifications for API is https://api.mambu.com/.

Mambu Java Client

The Mambu Java Client library is an open source library to interact with Mambu's APIs from your Java project. The library interacts with Mambu's REST APIs.

Using the original class files from the Mambu project, the library allows you to easily interact with Mambu via the APIs to retrieve and store information.

The library is continuously updated each time new functionalities are added to the Mambu's REST APIs and it is released once with the main Mambu product.

Usage

To use the Mambu Java API Wrapper, please include the following jars in your build path

• build/Mambu-APIs-Java-9.8-bin.jar
• build/Mambu-APIs-Java-9.8-bin-sources.jar
• lib/mambu-models-V9.6.jar
• further dependencies to run and test (see pom.xml for versions)
• httpclient
• httpcore
• gson
• commons-io
• commons-codec
• commons-logging
• google-collect
• jdo-api
• guice
• datanucleus-core

There is a list of services which are provided through a factory. The list will be updated constantly and currently contains:

• AccountingService
• ActivitiesService
• ClientsService
• CommentsService
• CustomFieldValueService
• CustomViewsService
• DatabaseService
• DocumentsService
• DocumentTemplatesService
• IntelligenceService
• LinesOfCreditService
• LoansService
• NotificationsService
• OrganizationService
• RepaymentsService
• SavingsService
• SearchService
• TasksService
• UsersService

To use the factory, some date must be provided in order to set it up:

MambuAPIServiceFactory serviceFactory = MambuAPIServiceFactory.getFactory(
    "mydomain.mambu.com", "username", "password");

    OR

MambuAPIServiceFactory serviceFactory = MambuAPIServiceFactory.getFactory(
    "mydomain.mambu.com", "username", "password", "user agent header value");

    OR

MambuAPIServiceFactory serviceFactory = MambuAPIServiceFactory.getFactoryWithApiKey(
    "mydomain.mambu.com", "DiiCtz7KgQnOi6vdkP1aRw9dCbseINot", "user agent header value");   

After this step, each service can be taken through a simple call like:

ClientService clientService = serviceFactory.getClientService();

See the classes from demo package for a few more examples of using the library

Or check out the javadocs here: http://mambu-gmbh.github.io/Mambu-APIs-Java/

Contributing to the Project

This is a community project and we'd love if you can contribute to make the Mambu API wrapper for Java better.

The project uses Maven for the build process. To make contributions to the project, fork it on GitHub, checkout the project and import it into Eclipse (or your favourite Java IDE) as a Maven 2 project.

Ensure to write JUnit tests for all contributions and rerun all existing tests (under /test) to ensure a high code quality.

When you're done with your changes, commit and push them to your GitHub fork and create a pull request so that we can review your code and incorporate the changes.

The Mambu team updates the Mambu models jar to account for changes in new releases as needed.