Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Määritelmän suhde "api managementtiin" --> Mikä näistä asioista vaikuttaa siihen, onko API avoin vai ei #35

Open
Mygee opened this issue May 16, 2016 · 1 comment

Comments

@Mygee
Copy link
Contributor

Mygee commented May 16, 2016

Avaan keskustelun tästä aiheesta.
Tyypillisesti API managementissa hallitaan esim näitä:
http://www.developereconomics.com/api-management-tools-how-to-find-the-one-for-you/
Eli:

  1. Documentation – Sounds boring, right? Still, one of the most common problems of developers is figuring out how an API works. Development time is too precious to waste in trial and error of an undocumented API. An API management service has to provide an easy way to read the documentation and enable developers to “try before they buy”. In some cases it is even possible to provide interactive documentation. Simplicity and usability are the keys!
  2. Analytics and Statistics – It is critical to understand how people use your API and get insights for your business.
  3. Deployment – Should be flexible and support public or private clouds, on-premises implementations, or combinations.
  4. Developer engagement – Engaging with your API consumers, developer or partners is important. Getting an easily accessible developer portal will significantly facilitate onboarding.
    Sandbox environment – This feature will increase both the value of an API and its adoption rate. What better than being able to develop and test your code.
    Traffic management and caching abilities.
  5. Security – APIs carry sensitive data, so it is important to protect the exposed information. The service has to at least provide identity and access management for users and developers.
  6. Monetization – Provide the capability to monetize your API.
  7. Availability – Should be available, scalable and redundant. An API environment can become demanding and the service should be able to deal with any kind of errors, problems or temporary traffic spikes.
  8. Support of Legacy systems.
@apoikola
Copy link
Member

samoin, kuin suhteessa tiedon semantiikkaan ( #37 ), niin ohjaavana kysymyksenä pitää olla, että:

Mikä näistä asioista vaikuttaa siihen, onko API avoin vai ei?

Lisäksi se, mikä pitää saada kristalloitua määritelmään on, että mikä on avoin rajapinta ja mikä on avoimen rajapinnan toteuttava rajapintapalvelu (rajapinnan yksi implementaatio). 1.0 versiossa ei olla paljoakaan otettu kantaa rajapintapalveluihin ja monet api management jutut koskevat rajapintapalveluja.

@Mygee Mygee changed the title Määritelmän suhde "api managementtiin" mitä käsitellään määritelmässä ja mitä ei. Määritelmän suhde "api managementtiin" --> Mikä näistä asioista vaikuttaa siihen, onko API avoin vai ei May 23, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants