Swagger 2.0 / Open API Initiative specifications:
This section will begin with the description of the Collaborative specifications development process & benefits of adopting the contract-first approach. Students will learn
Swagger 2.0 specification standard
How to create REST API specifications in YAML format
Tools options for Swagger specs editing
Benefits of Swagger 2.0
Demonstration of how specifications are leveraged by common platforms such as Apigee, Mulesoft & IBM API Connect
As part of the lectures, a complete specification will be created for ACME Vacations. At the end of this section student will be able to write Swagger/OAI specifications for their own API.
API Management:
API management is the process of publishing, documenting and overseeing application programming interfaces (APIs) in a secure, scalable environment. Lectures in this section cover the details of the following activities that an API provider carry out within the scope of API management.
Lifecycle management
Developer productivity
Developer portal
Security
Traffic management
Analytics
Productization
Monetization (API Economy)
APIgee, IBM API Connect & Mulesoft platforms will be used for demonstrating the various API management aspects discussed in the lectures. Students are encouraged to try out these platforms on their own to get a good feel of what API management platforms bring to table. The three platforms offer a free trial version that can be used for testing.
What Will I Learn?
Design and Develop RESTful API by applying the best practices & REST constraints
Create practices for API security, versioning, lifecycle management, documentation and other important aspects
Write specifications in Swagger2.0/OAI specifications in YAML format
Create an API management strategy for your enterprise
Leverage some of the common API management platforms for building API proxies (APIGEE, IBM API Connect, Mulesoft Anypoint)
Setting the stage:
- Introduction to the Author and the Course
- Summary decks download link for the course
- ACME Travels - Case study
- Tools for Design, Development,Testing and Management or REST API
- Crash course on MongoLabs
Evolution of RESTful services:
- What is an API
- Evolution of REST/JSON API
- Introduction to RESTful API
- API 101
- Private, Public and Partner API
REST API Architectural Constraints:
- Introduction to REST Architecture Constraints
- REST API Architectural Constraint - Client Server
- REST API Architectural Constraint - Uniform Interface
- REST API Architectural Constraint - Statelessness
- REST API Architectural Constraint - Caching
- REST API Architectural Constraint - Layered System
- REST API Architectural Constraint - Code On Demand
- Richardson Maturity Model for REST API
- REST API Architectural Constraints
Designing the REST API:
- API Value Chain
- Practices for Resource Names, Actions & Associations
- Implementing REST API CRUD operations
- Walkthrough: Creating a Vacations API in Node JS
- REST API Error Handling Practices
- Implement REST API
- Walkthrough: Implementation of error handling for POST API
- REST API Error Handling
- Handling changes to API
- Versioning the API
- API Caching (1 of 2) Concepts & Design decisions
- API Caching (2 of 2) Cache Control Directive
- Demo - API Caching using Cache-Control Directives
- API Caching
- Building support for Partial Responses
- Building support for Pagination
- Building support for Partial Responses & Pagination
REST API Security:
- REST API Security - Introduction
- Securing API with Basic Authentication
- API Basic Authentication
- Securing API with Tokens & JWT
- API Token based Authentication & JWT
- Securing API with API Key & Secret
- API Keys and Secret
- API Authorization using OAuth2.0
- API Authorization OAuth2.0
- API Security - Functional Attack
REST API Specifications using Swagger 2.0 / OAI:
- Requirements Analysis Process & Intro to REST Specifications
- REST API Specifications
- Swagger/OAI Specifications Walkthrough
- Introduction to Swagger/OAI specifications
- Swagger/OAI Specifications, Part 1 of 3
- Structure & Elements of Swagger/OAI specifications
- Swagger/OAI Specifications, Part 2 of 3
- Structure & Elements of Swagger/OAI specifications (2/3)
- Swagger/OAI Specifications, Part 3 of 3
- Structure & Elements of Swagger/OAI specifications (3/3)
API Management:
- Introduction to API Management
- API Lifecycle & Developer Productivity
- API Developer Portal
- API Security Management
- API Traffic Management
- API Analytics
- API Product and API Monetization