3.6.2.API Lifecycle & Developer Productivity

• Life cycle

  • Build -> Publish -> Deprecated (new version published) -> Retired

  • 團隊需要的原則

    • Establish processes, practices & roles

    • Publish roadmap in advance

    • Setup App developer communication

    • Leverage and creating tools

• Productivity

  • App developer needs:

    • 1.API documentation

    • 2.Self serve provisioning (開通服務)

      • Is basically related to App developer will get access to your API

    • 3.Support

    • How to if App developer has a problem or some thought, where do they go to the help from ?

      • Suggestion: Build developer portal to getting help, for getting access to the documentation, for

  • Api developer should think:

    • 1.Developer guildlines

    • 2.Frameworks

    • 3.Best practices

  • API management platform support

    • Design and development

      • Specifications based tooling

        • Mulesoft: 建立一個demo用的API (pecification), 需要Yaml

        • IBM Bluemix

          • allow to import Swagger specification or Open API specification

      • Utilities & tools

    • Policy based implementation

      • 除了functional requirement外, API developer也需要non-functional requirement, 如security management以及traffic management, code需要經常改變, 現在的平台也有提供這樣的服務

      • 支援格式: XML, JSON

      • create a proxy: apigee

    • Support for extensions

      • JavaScript, Java, Groovy