Resources & Knowledge

Everything you need to build better APIs

Tutorials, best practices, case studies, and deep dives — curated by our engineering team for developers and architects.

⌘K
32
Articles & Guides
1
Tutorials
3
Learning Paths
Sort:
Article
API Strategy

MCP, Function Calling, and Tool Use

Function calling, tool use, and MCP sound similar, but they live on three different layers. Which term means what, who coined it, and how they actually relate in practice.

Article
API Strategy

OpenAPI to MCP

If you already maintain an OpenAPI spec, you've done most of the groundwork for an MCP server. The interesting part isn't the technical mapping. It's deciding which endpoints actually belong in front of an agent, and how auth, quotas, and audit hold up in practice.

Article
API Strategy

What is MCP? The Model Context Protocol for Enterprise APIs, Explained

MCP has been around since late 2024 and is now supported by Claude, ChatGPT, Cursor, and a growing list of agents. The standard describes how agents reach external tools, data sources, and API functions. This article walks through what the Model Context Protocol actually delivers, how it relates to OpenAPI, and why enterprise teams should take MCP seriously in 2026.

Article
API Strategy

Migrating Swagger 2.0 to OpenAPI 3.0

Plenty of API specs are still on Swagger 2.0. The format is still around, but it stopped evolving years ago. Migrating to OpenAPI 3.0 today is rarely just a version-number swap.

Article
API Strategy

Spec-First API Development

With spec-first, the OpenAPI specification comes first and the code follows. This article shows how the approach works, which terms cluster around it, and when the switch actually pays off.

Article
API Strategy

OpenAPI Linting

Style guides live on wiki pages in plenty of organizations, but in day-to-day work they rarely get applied with any real consistency. OpenAPI linting turns them into an executable rule set that fires inside the pull request. This article walks through what style, security, performance, and compliance rules actually cover, and how that becomes a quality gate that holds up in the pipeline.

Article
API Strategy

OpenAPI 3.2 Explained

OpenAPI 3.2 has been out since September 2025. Three of its new features address pain points teams actually run into; the rest is smaller, but useful in specific spots. What 3.2 really delivers, and who benefits from making the jump.

Article
API Strategy

OpenAPI vs Swagger

Swagger and OpenAPI get used as synonyms, but they aren't the same thing. What's actually the standard in 2026, when migration becomes unavoidable, and which version is meant for what.

Article
API Governance

What Is API Governance?

API Governance defines how APIs are designed, released, and operated. Not as a bureaucratic overhead, but as a steering mechanism for quality, consistency, and security in growing API landscapes.

Article
API Strategy

What Is an API Developer Portal?

An API developer portal is far more than documentation. It makes APIs discoverable, understandable, and usable — for developers, partners, and business teams alike.

Article
API Strategy

API Strategy and Strategic Alignment

How organizations strategically manage their API landscape: capabilities over endpoints, ownership models, lifecycle planning, and what it means for budget decision-makers.

Article
API Strategy

API Customer Retention - Strategies that Offer Real Value to Developers and Companies

How effective customer retention and targeted monetization lead to sustainable growth thanks to API analytics and personalized developer experience.

Article
API Documentation

How to Document an API with Swagger – Step by Step

Swagger is easier than you think! This short introduction helps you get started with your API documentation immediately.

Article
API Documentation

Introduction to Swagger API - What is Swagger and Why is it Used?

Learn how Swagger supports the API-First approach and improves development through well-defined specifications.

Article
API Strategy

What are API products?

Treating APIs as products, from internal connector to monetizable asset. What makes an API product, the role of lifecycle, pricing, and developer experience, and why it's a lucrative market.

Article
API Business

Economic benefits of APIs

The economic value of APIs: how open interfaces accelerate processes, connect systems with each other, and create new revenue models. With examples from industry, retail, and finance.

Article
API Business

Flexibility and efficiency through APIs

Flexibility and efficiency through APIs. Why standardized interfaces resolve friction in complex business processes, and how API-first strategies shorten time-to-market.

Article
API Business

APIs in the Travel and Tourism Industry

APIs in the travel and tourism industry: how booking, availability, and loyalty APIs connect providers, platforms, and end customers. Concrete use cases and the standards that have caught on.

Article
API Business

The networked car - APIs in the automobile industry

The connected car as a data platform. Which APIs link vehicles to backends, apps, and third parties, from telemetry to OTA updates to mobility services. Standards, risks, and business models.

Article
API Business

API in E-Commerce

APIs in e-commerce, and how open interfaces connect online shops, marketplaces, and partner ecosystems. From payment to logistics to personalization — practice and patterns for online retail at scale.

Article
API Business

Finance - Open Banking

Open Banking, and how APIs are opening up finance. PSD2, account information services, and new business models. What banks are building, what fintechs do with it, and why standardized APIs are becoming mandatory.

Article
API Documentation

Swagger

The history and inner workings of Swagger, from a Wordnik side-project to today's OpenAPI Specification. What Swagger delivers, how it simplifies API documentation and integration, and the role the OAS plays now.

Article
API Fundamentals

RESTful API Modeling Language (RAML)

RAML as an alternative to OpenAPI: how the RESTful API Modeling Language provides reusable building blocks for API design, and when the YAML-based approach pays off.

Article
API Testing

API tests for more quality and security

API testing as a foundation for quality and security. Which test types matter, how automated tests fit into CI/CD, and which tools have proven themselves.

Article
API Strategy

API Business Objects

API business objects define the domain data structures an interface exposes. What good business objects look like, why they drive API adoption, and what to watch when modeling them.

Article
API Fundamentals

OpenAPI Specification (OAS)

OpenAPI Specification (OAS) the open API standard for a strong application networking and high digitalisation for software systems.

Article
API Fundamentals

API definition for powerful Web APIs

Find out which API description language is the most suitable. ✅ Open API ✅ SWAGGER ✅ RAML

Article
API Business

APIs in Logistics

APIs in logistics, from EDI predecessors to modern tracking, routing, and dispatch interfaces. How open APIs make supply chains transparent and lift efficiency on the last mile.

Showing 1–28 of 32 Resources

// Learning Paths

Structured Learning — Step by Step

Curated learning paths that take you from beginner to API expert.

Ready to transform your APIs?

Experience the platform for modern API management.