WeAreDevelopers Logo WeAreDevelopers
Sign in
For You LIVE
WeAreDevelopers LIVE • Aug 28, 2020

API Design - Getting Started

Alen Pokos

Stop reinventing data conventions. Treat your API as a stateless enabler. Learn how standardized JSON frameworks build resilient, maintainable backend ecosystems.

Pause
Mute Enter Fullscreen
#1 about 2 min

Defining web APIs and their primary business purposes

Connecting separate application spaces by defining standardized web interfaces that achieve specific business objectives.

#2 about 4 min

Understanding the core concepts of API design

Navigating disagreements around application systems by defining specific business purposes, usability bounds, and technical constraints.

#3 about 5 min

Balancing the client, API, and backend pillars

Ensuring reliable system architecture by keeping the client, API, and backend functioning cohesively without tight technical coupling.

#4 about 4 min

Leveraging the JSON API standard for data structure

Resolving formatting indecisions by utilizing the JSON API standard to rapidly orient relationships and structure documents.

#5 about 4 min

Designing a user registration process with separate endpoints

Removing complex multi-step state tracking from the server by utilizing separate endpoints that shift validation responsibility to client applications.

#6 about 4 min

Evolving listing resource designs for classified platforms

Adapting to new data requirements by keeping items isolated and associating complex seller profiles through explicit resource relationships.

#7 about 2 min

Implementing user-specific filtering and contextual endpoints

Tackling personal data retrieval challenges by providing standard identifier filters and context-aware URL pathways.

#8 about 4 min

Modeling conversations and messages to reduce resource redundancy

Preventing endpoint overload by generalizing seller and buyer identities into reusable conversation participants and implicit resource bindings.

#9 about 1 min

Managing resource types to prevent API maintenance complexities

Avoiding maintenance nightmares caused by overly specific endpoint types by consolidating participants into a generic system entity.

#10 about 2 min

Designing polymorphic resource endpoints for search functionalities

Returning diverse search matches efficiently by leveraging relationship wrappers that identify unique document varieties in a shared endpoint payload.

#11 about 3 min

Establishing core principles for data focus and naming

Escaping theoretical gridlock by standardizing naming layouts and prioritizing clear data provision over flawless architectural designs.

#12 about 1 min

Clarifying the boundary between requirements and API design

Maintaining scope by viewing API engineering as a direct tool to solve core product requirements instead of inventing new expectations.

#13 about 2 min

Tools for API documentation and relationship visualization

Improving system comprehensibility by employing external tools to test requests and map out complete resource relationship diagrams.

#14 about 2 min

Adopting standard error handling and endpoint testing practices

Guaranteeing reliable client responses by integrating standardized semantic status codes and automated postman testing procedures.

#15 about 1 min

Comparing GraphQL capabilities against the JSON API standard

Evaluating technology trade-offs by choosing between the unconstrained flexibility of GraphQL and the rapid delivery of standardized JSON structures.

#16 about 2 min

Choosing readable enum values over numeric backend identifiers

Preventing system confusion by substituting internal database numeric integers with human-readable string values for public usage.

#17 about 2 min

Optimizing performance across JSON methodologies and backend stacks

Overcoming endpoint slowness by recognizing that performance ultimately relies on targeted caching and specialized backend stack optimizations.

#18 about 2 min

Handling data pagination and endpoint versioning strategies

Structuring large datasets for rapid iteration by implementing systematic document pagination and transparent routing patterns.

#19 about 2 min

Applying business rules and permissions within API standards

Imposing correct boundaries by translating standard business terminology into universally recognized HTTP rules and permission constraints.

Matching moments

1:40 min

Summarizing key engineering lessons for platform API development

Anto Anto · World Congress 2024

3:32 min

Designing outstanding APIs with simplicity, safety, and evolvability

Anto Anto · World Congress 2024

1:02 min

Designing use-case driven APIs and consolidating broad endpoints

Pratim Bhosale Pratim Bhosale · World Congress 2025

3:35 min

Evaluating benefits and drawbacks of common API formats

Alexis Yushin Alexis Yushin · World Congress 2024

43 sec

Establishing a concrete vision for REST API development

Wekoslav Stefanovski Wekoslav Stefanovski · World Congress 2026 Europe

2:46 min

Standardizing design rules using the API Stylebook

Michael Jaeger Michael Jaeger · Europe 2026 Virtual

More from WeAreDevelopers LIVE

Fake or News - AI Music Detectors, Translating Ancient Languages & Tiny Heads in Teslas - Eddie Jaoude thumbnail
6:16
5 days ago

Fake or News - AI Music Detectors, Translating Ancient Languages & Tiny Heads in Teslas - Eddie Jaoude

Chris Heilmann, Daniel Cranney

Fake or News: AI Agents Hire Each Other, Spider-Man Ads in Cars & RAM Thieves - Marc Plogas thumbnail
5:46
10 days ago

Fake or News: AI Agents Hire Each Other, Spider-Man Ads in Cars & RAM Thieves - Marc Plogas

Chris Heilmann, Daniel Cranney, Marc Plogas

WeAreDevelopers - Of Agents and Robots thumbnail
1:04:42
11 days ago

WeAreDevelopers - Of Agents and Robots

Chris Heilmann, Daniel Cranney, Marc Plogas

WeAreDevelopers LIVE - How DevRel Makes Tech More Human thumbnail
48:06
18 days ago

WeAreDevelopers LIVE - How DevRel Makes Tech More Human

Chris Heilmann, Daniel Cranney

Fake or News: Smart Glasses in Court, Medical Advice Watches & Mushroom Electonics - Jason Torres thumbnail
7:41
19 days ago

Fake or News: Smart Glasses in Court, Medical Advice Watches & Mushroom Electonics - Jason Torres

Chris Heilmann, Daniel Cranney

Aliens in Quarantine, Python Deprecates Loops, and AI Buys Old Books - Zbyszek Tenerowicz thumbnail
5:43
about 1 month ago

Aliens in Quarantine, Python Deprecates Loops, and AI Buys Old Books - Zbyszek Tenerowicz

Chris Heilmann, Daniel Cranney

Upcoming sessions on this topic

Open session

World Congress 2026 North America

September 25, 2026 · 10:20–10:50

Stage 2

API = Some REST and HTTP, right? RIGHT?!

Rustam Mehmandarov

Passionate computer scientist

Rustam Mehmandarov
Open session

World Congress 2026 North America

September 25, 2026 · 12:20–12:50

Stage 9

Designing APIs That Survive AI Agents at Scale

Phani Pendurthi

Mastercard, Principal Software Engineer

Phani Pendurthi
Open session

World Congress 2026 North America

September 24, 2026 · 14:10–14:40

Stage 7

Designing High-Performance AI APIs: Lessons from Serving Millions of Real-Time Requests

Wayne Liu

Chief Growth Officer and Americas President of Perfect Corp.

Wayne Liu
Open session

World Congress 2026 North America

September 25, 2026 · 11:40–12:10

Stage 7

x402: Building Pay-Per-Request APIs for AI Agents

Brian Whippo

Senior Director Integrations and Developer Tooling, Algorand Foundation

Brian Whippo
Open session

World Congress 2026 North America

September 25, 2026 · 11:40–12:10

Stage 2

Reinventing Testing Practices in the AI Era

Eric Deandrea

Java Champion & Senior Principal Software Engineer, IBM

Eric Deandrea
Open session

World Congress 2026 North America

September 23, 2026 · 10:00–17:00

Stage 13

Building Pragmatic AI: 10 AI Features Your Users Actually Want

Jonathan "J." Tower

.NET Foundation Board | 12x Microsoft MVP | Founder & Consultant

Jonathan "J." Tower

Related videos

API = Some REST and HTTP, right? RIGHT?! thumbnail
27:25
World Congress 2025 • about 1 year ago

API = Some REST and HTTP, right? RIGHT?!

Rustam Mehmandarov

Rest API Antipatterns thumbnail
30:58
World Congress 2026 Europe • about 2 months ago

Rest API Antipatterns

Wekoslav Stefanovski

An Opinionated Guide to Bulletproof APIs thumbnail
27:13
World Congress 2026 Europe • about 2 months ago

An Opinionated Guide to Bulletproof APIs

Rustam Mehmandarov

The Great API Debate: REST, GraphQL, or gRPC? thumbnail
28:16
World Congress 2024 • about 2 years ago

The Great API Debate: REST, GraphQL, or gRPC?

Alexis Yushin

Awful APIs: A History Lesson in Industry Mistakes and Mishaps thumbnail
28:55
World Congress 2023 • almost 3 years ago

Awful APIs: A History Lesson in Industry Mistakes and Mishaps

James Seconde

REST, GraphQL, gRPC, and more: A comparison of modern API styles thumbnail
30:16
World Congress 2026 Europe • about 2 months ago

REST, GraphQL, gRPC, and more: A comparison of modern API styles

Florian Bader

Related articles

From learning to earning

Jobs that call for the skills explored in this talk.