Discussion

What APIs exist currently?

Ben Webb - IATI Secretariat
Ben Webb - IATI Secretariat • 25 July 2014
2 comments

We should maintain a list of all the IATI related APIs somewhere, possibly with a list of relevant contacts, and whether the developers are involved in this working group.

I’ve turned this post into a discourse “wiki post”, so hopefully anyone should be able to edit and add links as appropriate. It’s still part of the forum though, so if you prefer you can reply with a comment instead.

List of APIs

Current:

Additionally the IATI Dashboard is built off a poorly documented static JSON API.

In development

Comparison of APIs

We should probably have a full “feature matrix” to compare APIs.

For now, Steven Flower has been doing some work comparing the number of activities in different APIs - https://docs.google.com/spreadsheet/ccc?key=0AqXcKmXbCG-OdGN2NnBHa0NqY0JEbjhSaURaWWtCaXc&usp=drive_web#gid=0

Comments (2)

Steven Flower
Steven Flower • 9 years ago

(from call on 26th September)

Those on the call agreed that a “feature matrix” would be a useful next ste. This would include:

  • listing of all APIs
  • evaluation of overall status (dead vs live!)
  • in depth listing of functions/features of existing/live APIs

Such a feature matrix would enable the Working Group to chart next steps.

We are looking for volunteers to work on this

Anonymous • 9 years ago

Work done in the past:

docs.google.com IATI API Convention - Working Draft

IATI API Conventions / Standards This is a 0.1 document produced as the result of a meeting of the IATI community in November 2012 and revised following conversations in January 2013. A slide deck summarising key issues discussed on the 15th...

  • Define exact scope for the API standarisation

  • API’s current status - analysis

  • User needs on API level

  • DFID need speccing it more

  • Seperate API’s

  • Activity level API

  • Organisation level API

  • Aggregate API (sub function for API?)

  • API standard based on IATI V2.0.1 - probably goes live Q1/Q2 2015

  • API convention wrt IATI

  • API should support all IATI versions? Probably not bind it to a specific version

  • API as a Service?

  • Impact of IATI upgrade to 2.0.1 on current API’s

  • Which API’s out there - What APIs exist currently?

  • Master API layer that talks to the variety of API’s? Performance RISK.

  • Single API contract: if you put a request to API in same format and send the call to any of those API’s, they should all send the same result

  • Future: construct your own custom queries

  • Common URI structure to align all API’s

  • Datastores/API as a service (DFID)

  • Feature matrix for comparison?

  • Based on What APIs exist currently? set a shortlist of ‘active’ API’s and focus the matrix comparison on those alone.

Please log in or sign up to comment.