OBP-API/README.md

64 lines
2.1 KiB
Markdown
Raw Normal View History

2013-01-14 13:57:22 +00:00
# README
2011-10-16 13:40:36 +00:00
2013-01-14 13:57:22 +00:00
Welcome to the Open Bank Project API
2011-10-16 13:40:36 +00:00
2013-01-14 13:57:22 +00:00
## ABOUT
2013-01-14 16:03:32 +00:00
The Open Bank Project is an open source API for banks that enables account holders to interact with their transaction data using a wider range of applications and services.
2013-01-14 16:03:32 +00:00
The OBP API supports transparency options (enabling account holders to share configurable views of their transaction data with trusted individuals and even the public), data blurring (to preserve sensitive information) and data enrichment (enabling users to add tags, comments and images to transactions).
Thus, the OBP API aims to abstract away the peculiarities of each core banking system so that a wide range of apps can read (and one day write) transactions to multiple banks. We want to raise the bar of financial transparency and enable a rich ecosystem of innovative financial applications and services.
Our tag line is: Bank as a Platform. Transparency as an Asset.
2013-01-14 15:57:46 +00:00
The API provides OAuth 1.0 authentication.
2013-01-14 15:57:46 +00:00
## DOCUMENTATION
2013-01-14 13:57:22 +00:00
Please refer to the [wiki](https://github.com/OpenBankProject/OBP-API/wiki) to see the API specification.
2013-01-14 13:57:22 +00:00
## STATUS
2013-06-22 07:12:54 +00:00
[V1.2] (https://github.com/OpenBankProject/OBP-API/wiki/REST-API-V1.2) is mostly implemented
2013-01-14 13:57:22 +00:00
## LICENSE
This project is dual licensed under the AGPL V3 (see NOTICE) and a commercial license from TESOBE
Some files (OAuth related) are licensed under the Apache 2 license.
2013-01-14 13:57:22 +00:00
## SETUP
2013-06-22 07:19:27 +00:00
Vagrant and Puppet scripts are available [here](https://github.com/OpenBankProject/OBP-VM) to create a Virtual Box VM running the Open Bank Project API.
2013-06-22 07:17:48 +00:00
Note: These may be a bit outdated.
2013-01-14 13:57:22 +00:00
2013-06-22 07:12:54 +00:00
Otherwise use sbt or Maven 2 as a build tool.
2011-10-16 13:40:36 +00:00
----
2013-06-22 07:12:54 +00:00
SBT:
2013-07-05 07:45:14 +00:00
To compile and run jetty execute:
$ sbt
...
> compile
> ~;container:start; container:reload /
(Note that you first have to start sbt and then on its console start jetty with the container:start task, otherwise it will exit immediately. More here: https://github.com/siasia/xsbt-web-plugin/wiki)
2011-10-16 13:40:36 +00:00
In OS X, sbt can be installed with $ sudo port install sbt
----
2013-06-22 07:12:54 +00:00
Maven:
mvn jetty:run
2011-10-16 14:30:22 +00:00
2013-06-22 07:17:48 +00:00
----
# Databases:
The default datastores used are MongoDB (metadata, transaction cache) and Postgres (user accounts).