{"id":25144551,"url":"https://github.com/openmf/fineract-client","last_synced_at":"2025-04-28T11:20:56.927Z","repository":{"id":48048231,"uuid":"288483049","full_name":"openMF/fineract-client","owner":"openMF","description":"Mifos Fineract Client is a Java based library that provides a simple interface to interact with the Apache Fineract 1.x Platform APIs","archived":false,"fork":false,"pushed_at":"2025-03-26T16:00:36.000Z","size":4369,"stargazers_count":14,"open_issues_count":8,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-26T17:21:46.670Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openMF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-18T14:45:18.000Z","updated_at":"2025-03-26T16:00:45.000Z","dependencies_parsed_at":"2022-08-12T17:30:44.925Z","dependency_job_id":"b5f55663-9411-4f7e-9704-85b7899ba86b","html_url":"https://github.com/openMF/fineract-client","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Ffineract-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Ffineract-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Ffineract-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openMF%2Ffineract-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openMF","download_url":"https://codeload.github.com/openMF/fineract-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251302769,"owners_count":21567601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-08T19:46:42.989Z","updated_at":"2025-04-28T11:20:56.915Z","avatar_url":"https://github.com/openMF.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"### 🚨 Deprecation Notice\n\nThe Fineract Client ([https://github.com/openMF/fineract-client](https://github.com/openMF/fineract-client/)) is now deprecated and will no longer receive updates or active support.\nWe recommend migrating to our new and improved, multiplatform-compatible client:\n👉 Fineract Kotlin Multiplatform Client: [https://github.com/openMF/fineract-client-kmp](https://github.com/openMF/fineract-client-kmp)\n\n# Fineract API Client Library [![Build Status](https://travis-ci.com/openMF/fineract-client.svg?branch=master)](https://travis-ci.com/openMF/fineract-client) [![Jitpack](https://jitpack.io/v/openMF/fineract-client.svg)](https://jitpack.io/#openMF/fineract-client) [![License: MPL 2.0](https://img.shields.io/badge/License-MPL%202.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)\n\nA **Java** and **Retrofit2** based **Fineract Client Library** that you can use to interact with the **Apache Fineract 1.x Platform**. This library is autogenerated using **Swagger Codegen**. It can be used in Android or any Java and Kotlin Project.\n\n_This library duplicates \u0026 overlaps with the \"official\" [Apache Fineract client library](https://github.com/apache/fineract/blob/develop/fineract-doc/src/docs/en/chapters/sdk/client.adoc), see [#29](https://github.com/openMF/fineract-client/issues/29)._\n\n## Add Dependency\n\n### Gradle\n\nTo use library in your gradle project follow the steps below:\n\n1. Add this in your root `build.gradle` at the end of repositories:\n    ```groovy\n    allprojects {\n        repositories {\n            ...\n            maven { url 'https://jitpack.io' }\n        }\n    }\n    ```\n2. Add the dependency\n   ```groovy\n   dependencies {\n       def client_Version = \"2.02\"\n       implementation \"com.github.openMF:fineract-client:$client_Version\"\n   }\n   ```\n\n### Maven\n\nTo use the library in your Maven project, follow the steps below:\n\n1. Add the JitPack repository to your build file:\n    ```xml\n    \u003crepositories\u003e\n        \u003crepository\u003e\n            \u003cid\u003ejitpack.io\u003c/id\u003e\n            \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n        \u003c/repository\u003e\n    \u003c/repositories\u003e\n    ```\n2. Add the dependency\n    ```xml\n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.github.openMF\u003c/groupId\u003e\n        \u003cartifactId\u003efineract-client\u003c/artifactId\u003e\n        \u003cversion\u003e2.0.2\u003c/version\u003e\n    \u003c/dependency\u003e\n    ```\n\n## Usage\n\nExample code to use the **Authentication API**:\n\n```java\nimport io.reactivex.schedulers.Schedulers;\nimport org.apache.fineract.client.models.PostAuthenticationResponse;\nimport org.apache.fineract.client.util.FineractClient;\nimport org.reactivestreams.Subscriber;\n\npublic class Main {\n   public static void main(String[] args) {\n      FineractClient client = FineractClient.builder()\n              .basicAuth(\"mifos\", \"password\")\n              .tenant(\"default\")\n              .build();\n      \n      PostAuthenticationRequest body = new PostAuthenticationRequest();\n      body.setUsername(\"mifos\");\n      body.setPassword(\"password\");\n      \n      client.authentication.authenticate(body, false)\n              .observeOn(Schedulers.newThread()) // use scheduler based on different scenarios, in case of android use 'AndroidSchedulers.mainThread()'\n              .subscribeOn(Schedulers.io())\n              .subscribe(new Subscriber\u003cPostAuthenticationResponse\u003e (){\n                 @Override\n                 public void onNext(PostAuthenticationResponse postAuthenticationResponse) {\n                    // handle next events here\n                 }\n\n                 @Override\n                 public void onError(Throwable t) {\n                    // handle error events here\n                 }\n\n                 @Override\n                 public void onComplete() {\n                    // handle on completed events here\n                 }\n              });\n   }\n}\n\n```\n\n## Build Project\n\nClone the repository and import as Maven project in IntelliJ IDEA or Eclipse\n\nBefore building the project, make sure you have the following things installed.\n\n- Maven\n- Java 11\n\nTo install the API client library to your local Maven repository, simply execute:\n\n```shell\nmvn install\n```\n\nTo build the library using Gradle, execute the following command\n\n```shell\n./gradlew build\n```\n\nRefer to the [official documentation](https://maven.apache.org/plugins/maven-deploy-plugin/usage.html) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmf%2Ffineract-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenmf%2Ffineract-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmf%2Ffineract-client/lists"}