Learning objectives

In this lectures you will learn

• What is an API
• What APIs enable and why they are central today from both a business and engineering perspective
• How to design APIs and expose as a service the functionality of your software

Apiary and OpenAPI

In the course we use Apiary as a tool to define, expose and mock APIs. Please register at apiary.io

We will expose the APIs on heroku.com

Reading material (required for exam)

Material to prepare for the exam is available at this google docs, accessible only after UNITN login: https://docs.google.com/document/d/1NAECMaGU7gLC26SIgwRWkWI4g-hG44lP1if2SqSapx0/edit?usp=sharing

Useful additional material

• Bernhard Haslhofer's RESTful Webservice APIs Recommended Readings:
  • Foy Fielding: Architectural Styles and the Design of Network-based Software Architectures (Chapters 4-6).
  • Brian Mulloy: RESTful API Design - Second Edition (free eBook + Webcast)

Complete Lectures:

• RESTful Webservice APIs
• RESTful Webservice APIs - Group brainstorming
• RESTful API Design

Other

• How to build APIs
• SWAGGER Tutorial
• Best practices of API Design
• API Design
• Orthogonality of Specifications
• Architecture of WWW

Exercise

Available at: https://github.com/2018-Trento-SEII-INFORG/APIsExercise