apidays LIVE LONDON - Discovering API Version differences with ease by Jaap Brasser

Nov 2, 2020Download as PPTX, PDF0 likes42 views

apidays LIVE LONDON - The Road to Embedded Finance, Banking and Insurance with APIs Discovering API Version differences with ease Jaap Brasser, Developer Advocate at Rubrik

Discovering API Version differences with ease
October 27 & 28, 2020#APIDays

Tweets
Codes
Works
Does
Likes
jaap_brasser
jaapbrasser
Developer Advocate
Blogger, Speaker, Coder
Cloud Automation & Security

Use cases
• Backup
• Cloud Data Management
• Disaster Recovery
• Anomaly detection
• Test / Dev scenarios

Rubrik API Architecture
Authentication:
• Basic (user/pw)
• API token
Rubrik UI
same logic applies
API Abstraction:
• SDK
• Plug-in
• Automation tool
Consumes 3rd party APIs:
• Amazon S3 API
• Blob Service REST API
Spray - framework for building REST/HTTP-
based integration layers
Spray-can - lightweight HTTP server that
handles REST methods
Spragger - generates code using OpenAPI spec
REST API
*OpenAPI spec
Versioned:
/internal
/v1
/v2

Who are we dealing with
Different roles, different expectations

Downstream Dependencies
Browser & Desktop Tools
Chrome Developer Tools
Automation Tools
Playground
Direct
SDK
Abstraction
Plug-in
https://build.rubrik.com

apidays LIVE LONDON - Discovering API Version differences with ease by Jaap Brasser

Challenges • Reading changelogs
• Different product versions
• Downstream languages
• New functionality

Ideal Scenario
• Generate report on version diffs
• Report breaking changes
• Moved endpoints
• Changes in status / body / param
• Report on SDK changes

What we’ve built
Eternally work in progress
Comparison
Framework
Swagger
Definitions
Downstream
SDK Analysis
Reports

Lessons Learned
Changelogs
are not fun
01
Automation
is fun
02
Edge cases
03
New
functionality
04
Integrate in
processes
05

This document discusses the need for reconstructing API specifications from runtime traffic without source code access. It provides an overview of existing open source solutions and their limitations. It then introduces APIClarity, an open source tool that monitors API traffic using a service mesh to automatically generate OpenAPI specifications, allows users to review and approve specifications, and detects differences between specifications and runtime behavior. The document demonstrates APIClarity using a sample application and discusses plans for additional features.

apidays LIVE Jakarta - Better API DX with a CLI by Phil Nash, Twilioapidays

Build pipelines with TeamCity and Kotlin DSLAnton Arhipov

- TeamCity allows building software projects and managing build pipelines for continuous integration and delivery (CI/CD) - A build pipeline in TeamCity refers to the sequence of build steps such as compiling code, running tests, and deploying artifacts that are automatically triggered by code changes - The document demonstrates how to define a build pipeline in TeamCity using Kotlin DSL that compiles and packages a Java application project and its dependency library project

apidays LIVE Hong Kong 2021 - Automating the API Product Lifecycle by Jeremy ...apidays

TDD for APIs in a Microservice World (Short Version) by Michael Kuehne-Schlin...Michael Kuehne-Schlinkert

It can be tough to test an apparently simple service comprehensively. A microservice architecture brings a new level of complexity to the question “How can we validate that our API is working as intended?” In this talk Michael will explain how to use test driven development for APIs and even further how TDD can drive an API Design towards a more usable design, and how to build an well-tested ecosystem of microservices. This approach is applicable for different kinds of services (REST APIs, websockets, industrial protocols). Independent from the type of interface we always ran into similar problems when we build an ecosystem of services. We have to deal with dependency, asynchronous behaviours, fallback mechanisms, endpoint versioning and sometimes even shared databases. It’s not trivial to apply TDD to these kinds of problems cause you have to think of scenarios. But there are ways of identify these scenarios and to test them. As an API specialist Michael worked with various clients designing, building, testing, maintaining and even redesigning private and public services. Based on his project experience he developed a practical approach to apply TDD to APIs in microservice ecosystems.

apidays LIVE Australia 2020 - Evaluating the usability of security APIs by Dr...apidays

WEB API GatewayKumaresh Chandra Baruri

apidays LIVE Hong Kong 2021 - Multi-Protocol APIs at Scale in Adidas by Jesus...apidays

1. The document discusses the need for an integration specification to manage APIs that use multiple protocols and styles at large companies. 2. An integration specification would provide a single source of truth for technical metadata about APIs, including how they are structured, the data they manage, and how they relate to each other and enterprise data. 3. This would enable automated API discovery, integration, and management processes by describing APIs and their access to data products at an enterprise level.

Rest api best practices – comprehensive handbookKaty Slemon

This document provides an overview of REST API best practices. It discusses the key aspects of REST API design, including the 6 architectural constraints of REST (uniform interface, client-server, stateless, cacheable, layered system, and code on demand). It also outlines 12 best practices for REST API design, such as using nouns instead of verbs in URIs, plural naming conventions, implementing HATEOAS, and using Swagger for documentation. The document serves as a comprehensive guide to building robust RESTful APIs.

What's an apiJacques Ledoux

Public APIAmir Zuker

Contract {Collaboration} Driven Development - APIdays Interface 2020Alianna Inzana

In the API space, much of the conversation around Contract Driven Development has centered on the question “Did we build the API right?“. By using the contract as the foundation for a common understanding of the API, we can answer not only that question, but the equally important - but more elusive - “Did we build the right API?“. In /Contract/{Collaboration}/DrivenDevelopment, we will discuss how API Specifications and consumer-driven contracts can form the basis for cross-team collaboration in delivering quality services.

apidays LIVE Paris - Innovation and rejuvenation combined: a beneficial appro...apidays

The Magic Behind Faster API Development, Testing and Delivery with API Virtua...SmartBear

API virtualization allows for faster development, testing, and delivery of APIs. It involves simulating API responses without accessing the actual implementation through techniques like static mocking, dynamic mocking, and runtime simulation. This allows isolating components, enabling early development and testing, and providing sandboxes. Virtualization can be done by generating responses from API definitions, capturing real traffic, or refining with dedicated tooling. It is particularly useful for complex systems with many interdependent components and external dependencies.

Tools and techniques for APIsJason Harmon

Pure APIs: Development workflows for successful API integrationsJosé Haro Peralta

APIs are the fundamental tenets of the Internet. They enable integrations between different services, and they power the servers that bring our applications to life. API integrations lay at the core of our API-driven world, and delivering successful API integrations is fundamental to sustain it. However, more often than not, API integrations tend to fail due to ineffective development workflows. In this presentation, I want to present various API development workflows that have helped me and my clients deliver successful API integrations. I’ll show how documentation-driven development, using mock servers, robust API testing frameworks, and API visibility tools can help to significantly reduce the chances of API integration failure and to keep errors under control.

apidays LIVE Paris 2021 - Taming the beast by Markus Mueller, Apiidaapidays

apidays LIVE Hong Kong 2021 - GraphQL : Beyond APIs, graph your enterprise by...apidays

Kasten securing access to your kubernetes applicationsLibbySchulze

The document discusses securing access to Kubernetes applications using Dex for authentication and RBAC for authorization. It provides an overview of Dex and how it can be used to authenticate users against an existing identity provider like Active Directory. It then covers Kubernetes RBAC and how it can be used to define roles and role bindings to control authorization and grant varying levels of access to different user types like cluster administrators. It includes examples of defining roles, role bindings, and checking user access using kubectl auth can-i.

apidays LIVE Hong Kong 2021 - Better API DX with a CLI by Phil Nash, Twilioapidays

apidays LIVE Hong Kong - Orchestrating APIs at Scale by Hieu Nguyen Nhuapidays

apidays LIVE New York 2021 - Service API design validation by Uchit Vyas, KPMGapidays

[apidays Live Australia] How do you enhance customer experience through event...WSO2

apidays LIVE Australia 2020 - Building a scalable API platform for an IoT eco...apidays

apidays LIVE Paris 2021 - Inside API delivery Pipeline, the checklist! - Fran...apidays

Api gatewayenyert

This document provides an overview of API gateways and their role in microservice architectures. It begins with a brief history of monolithic architectures and how microservices emerged as a solution. It then defines key concepts like APIs, gateways, and how they relate. The main points are: 1) An API gateway acts as a single entry point and centralizes request routing, protocol translation, and provides cross-cutting features like authentication, monitoring and security for internal microservices. 2) Gateways help reduce complexity and overhead by encapsulating microservices and allowing transformations, while also improving reusability and security. 3) Examples of API gateway tools are provided, as well as a proposed activity, before concluding

What is an API Gateway?LunchBadger

apidays LIVE London 2021 - Application to API Security, drivers to the Shift ...apidays

API workshop: Introduction to APIs (TC Camp)Tom Johnson

Microsoft graph and power platform champKumton Suttiraksiri

พบกับเซสชั่น "Microsoft Graph for Microsoft 365 and Power Platform" ในงาน Microsoft 365 Developer Bootcamp - แนะนำ Microsoft Graph - เรียนรู้การเรียกใช้งาน REST API เพื่อเข้าถึงข้อมูลบนบริการต่าง ๆ ของ Microsoft 365 โดยคุณแชมป์ Narisorn Limpaswadpaisarn (Microsoft Certified Trainer)

More Related Content

What's hot (20)