This archive is now a read only site.
There is also a copy of the history that has been converted into a git repository at: https://github.com/IATI/IATI-Wiki-Archive.
Please do not rely on any of the information found here.
Table of Contents
OIPA stands for Openaid IATI Parser and API. It has been developed within the OpenAid NL project and runs as an open webservice. Anyone can use it with the data residing in the OIPA network.
OIPA enables IATI standard compliant datasets to easily parse and interface IATI compliant data. OIPA runs as a webservice, which is being reffered to as the OIPA network. OIPA consists of several software components which are dependent on each other.
- Parser makes the IATI compliant available xml datasets available in the non xml database MySQL.
- The datamodel residing in MySQL contains different IATI sets that have been mapped in the parser.
- The API enables web-platforms to easily interface using REST calls to pick up data.
At present the OIPA network holds data from the Dutch Ministry of Foreign Affairs.
Documentation & examples
Check the OIPA documentation and create some REST yourself.
REST calls examples OIPA network:
- http://search-api-data.openaid.nl/api/data/activity/ | Shows alls activities by Dutch ministry of Foreign affairs
- http://search-api-data.openaid.nl/api/data/activity/88/ | Shows specific id of an activity
- http://search-api-data.openaid.nl/api/data/activity/?recipient_country_code=ZW&total_budget__gte=2000000 |Shows activities in a specific country (ZW) with a budget over €2.000.000
- http://search-api-data.openaid.nl/api/data/activity/?description__contains=human%20rights | Shows all activities where the description contains “human rights”
- http://search-api-data.openaid.nl/api/data/activity/?sector=Public%20finance%20management |Shows all activities in the sector “Public finance management”
- http://search-api-data.openaid.nl/api/data/transaction/?activity_id=2 | Shows all transactions within a activity (id=2)
- http://search-api-data.openaid.nl/api/data/transaction/?activity_id=2&transaction_date__gte=2010-12-31 | Shows all transactions within a activity (id=2) and later than 2010-12-31
After decoding the JSON into variables, the data can be used in a HTML page (eg create table). Nearly every language has a JSON decoding library. Here are some examples:
Links, source code and development plans
You can find the AGPL licensed code for both the User Interface for openaid.nl at Github. You will also find the OIPA webservice which you can download, use and test with. OIPA is also released under the AGPL licence.
Developments for 2012 will consist of producing openaidsearch (operational late June 2012) which will also be powered by OIPA.