ExchangeBC / Our-Project-Docs

BCDevExchange artefacts including documents, templates, a WIKI and other useful things.
Other
14 stars 9 forks source link

Spike: API Management R2 #30

Closed kelpisland closed 9 years ago

kelpisland commented 9 years ago

An idea being explored and shaped. Open for discussion, but may never go anywhere.

SPIKE:

As a program manager I need to investigate other open source API management technologies so that I can make a strategic decision about the which services and technological framework the exchange should provide for the first year.

Additional detail:

Background: As part of release 1 the dev team investigated various API magagment tools and settled on using WSO2 as a Proof of Concept to enable the first vision of the BCDevExchange.org site. Output from that is avaialble aa part of this V1 Architecture Document

Links:

Version 1 of live API console as part of R2

Success criteria:

  1. Tech spike microservice architecture (Kong/StrongLoop other?)
  2. Keys via Oauth2 user i.e.: Github
  3. UI for console
  4. Replication model for api providers
  5. Preserve API providers dns/namespace
  6. Policy management (isolated or federated or?)
  7. Shared authentication/user id via devexchange account service?
  8. decision matrix criteria
  9. Inform management team of approach before end of first sprint week
  10. attend every management open meeting and demonstrate progress
  11. Assumed Todd @kelpisland will lead the spike.
  12. Kong/StrongLoop other? - API Keys
  13. Kong/StrongLoop other? - Rate control / throttling
  14. Gelato? - API Console (Available as of Oct 1)
  15. Mashape Analytics - Statistics / Reporting
  16. Kong/StrongLoop other? REST API - Ability to integrate with CKAN

    Deliverables:

    • Brief summary doc(s) posted to this repo
    • Proof of concept (limited in scope to Open511)
ll911 commented 9 years ago

We should compare StrongLoop with Mashape not just Kong StrongLoop is an API platform including multiple components that is solely designed for nodeJS

Mashape (including kong, analytic, gelato.io, Postman and mockbin) is current CLOUD API Market Place in Production.

kelpisland commented 9 years ago

Agreed- I don't want to limit the exploration, the more avenues that can be explored in the time we have the better we can map our way forward.

kelpisland commented 9 years ago

Added Spike 30 Meeting Notes 2015-09-22

ll911 commented 9 years ago

Thx Fred for the detailed feature maps for DevX, I like to add 3M to selection criteria.

f-w commented 9 years ago

@watkinspd showed me this tool - swagger.io which contains a swagger editor with online demo. Is it too geeky to expose raw swagger text to devx api provider?