Designing REST-based APIs

A wide overview of the things to care about if you build and deploy RESTful services that will survive the real world. The course covers architecture, security, testing, scaling and other best practices that will help you to avoid the common mistakes.

This course gives you a wide overview of the things to care about if you build and deploy RESTful services that will survive the real world. It covers architecture, security, testing, scaling and other best practices that will help you to avoid the common mistakes.

After this class you will know what things to focus on when you design and operate a public API. You will also have some ideas on how to use REST internally inside your organization.

Audience

Teams or developers planning to develop their first REST-based API.

Prerequisites

Basic understanding of http and how the web works.

What you will learn

Introduction APIs and REST

• What are APIs
• XML and JSON
• What is REST
• Resources
• Verbs
• HTTP
• URIs

RESTful design

• URI structure
• Modeling
• Media types
• Versioning
• Paging

Hypermedia

• Intro to Hypermedia
• hypermedia formats

OpenAPI

• Swagger
• Tooling

API Architecture

• Idempotency
• Fault tolerance
• Queued operations
• Throttling
• Webhooks
• API First approach

REST Alternatives

• OData
• GraphQL

Logging and debugging

• Request tracking
• Distributed Tracing

Security

• Properties of a secure REST API
• Threats
• HTTPS & certificates

Authentication and Authorization

• Tokens and claims
• OAuth
• OpenID Connect