5 Keys to API Design - API Days Paris 2013

•

4 j'aime•1,462 vues

Daniel Feist

Technologie

The New Enterprise

All contents Copyright © 2013, MuleSoft
Inc.

7

The New Enterprise

SaaS
Cloud platforms

Social

Mobility and Devices

Customers / Partners
/ Suppliers

Packaged apps

Custom apps

Big Databases / Big Files

The New Enterprise

1,000s
100s

SaaS

Cloud platforms

Social

1,000,000,000s

100,000s

Mobility and Devices

Customers / Partners
/ Suppliers

Packaged apps

1,000,000s

Custom apps

Big Databases / Big Files

The New Enterprise

SaaS
Social

Cloud platforms

Open web APIs
Mobility and Devices

Customers / Partners / Suppliers

B2B APIs

Product APIs
Internal APIs

Packaged apps

Custom apps

The New Enterprise

Databases

The API Contract Is Critical

•  tells consumer devs what they'll get

•  tells implementer devs what to deliver

•  enables parallel development

•  ensures they'll meet in the end

What kind of contract do we want?

1.  Describe APIs simply and clearly

2.  Design APIs easily and soundly

What kind of contract do we want?

Document your API?

or
Model your API?

The Key to API Success?

how?
• 
• 
• 
• 

design for them
iterate quickly
model cleanly and consistently
gather feedback

Design For Your Users

UI à UX
Valida
te

API à APX

Capture
Feedback

Think APX!
This is a long-lived interface,
ladies and gentlemen

Don't expose dirty laundry

!

users

products
orders

è

invoices

Craft it for your users:
what will they love?

Types of Patterns

•  Resource Types
•  Collection
•  Collection Member
•  Document

•  Traits
•  Secure
•  Paged

Engage Developers

•  Social Tools
•  Rate, discuss
•  Provide feedback

•  Interactive Console
•  Prototyping Tools

Verdict:

manifest
structure

capture
patterns

humanly
writeable

let's try
harder…

No Need to Start From Scratch!

• 
• 
• 
• 
• 
• 

well-known superset of JSON
optimized for human readability
great for hierarchies
cruft-free
broad tooling base
extensible-ish

RAML

RESTful API Modeling Language
A new open spec
for RESTful APIs
that's as clean
and as structured
as REST itself
the RAML Workgroup:
raml.org

RAML: Reuse

resource type
schema

trait

Covers Full HTTP
optional version in baseUri
template URIs

query parameters

headers (on request and response)
response per status code
example (and schema) per media type

Patterns: Resource Types
externalizable
inheritance
pull in traits

parametrize

Patterns: body schemas
XML schema
JSON schema
or just use good ol'
form data:

examples

Patterns: security schemes
username/password; cleartext or use digest
end user allows app to access their data
better to put token in header, not query

the OAuth multi-step dance

What's next?

q growing library of API specs in RAML (e.g. on APIhub)
q converters (import WADL, Swagger etc.)
q client generators
q server frameworks (e.g. MuleSoft APIkit; node.js)
q JAX-RS Support
q testing frameworks
q mocking services (e.g. on APIhub)
q <insert your ideas here>
q evolve RAML spec (RAML workgroup)

Contenu connexe

Tendances

Simon Phipps, President, Open Source Initiative Open source is not about free stuff. It's a way of granting permission in advance so that innovation can happen without obstruction and so loose-knit communities can collaborate freely. As such, it's more important than ever in an age of APIs, devices and distributed web infrastructure. This session will: Explain the dynamics of open source licensing Consider the relative merits of licensing "strengths" for IoT Discuss the challenges of software patents to APIs and open collaboration.

Open Source And the Internet Of Things

ProgrammableWeb

Breaks down Google v. Oracle and what it means for the future of software development and fair use. This legal contest has been heralded as the “World Series of IP cases” and the “copyright case of the decade”. It’s a landmark case, 11 years in the making, between two industry heavyweights – Google, the undisputed king of search and mobile operating system market share, accused of both patent and copyright infringement against Oracle, the owner of the ubiquitous Java API. At stake is a winner take or keep-all purse of $9 billion in damages and a Supreme Court ruling that will dictate the future of software interface copyright law. Ashley Sloat, President & Director of Patent Strategy here at Aurora, serves as your guide, cutting through 11 years of case law, 3 trials, 2 appeals, and endless technology metaphors, all in an illuminating IP conversation that runs the gamut from patent infringement to copyright violation and ultimately settles on a matter of fair use doctrine. Blog: https://www.aurorapatents.com/blog/new-podcast-google-v-oracle Podcast: https://patentlystrategic.buzzsprout.com/1734511/8468565-google-v-oracle-the-future-of-software-and-fair-use

Google v Oracle: The Future of Software and Fair Use

Aurora Consulting

Just a few years back, lack of a standard way to document, govern or describe a contract for the APIs acted as a deterrent to API adoption within the enterprise. WSDL 2.0 and WADL provided early support, but they couldn’t truly capture the essence of RESTful APIs. Recently we have seen the emergence of several description languages. New ways to describe and document APIs have emerged such as Swagger, RAML, API Blueprint and others, each taking a slightly different approach.

API Description Languages

Akana

So, here we are: Microservices, and everything they bring with them, like Spring Cloud, Kubernetes, Docker, ELK, you name it. We learnt and worked hard to master all of it. And now, finally, we feel prepared for the next years to come. Hmm, but what about Digitization? So what! Dissolving market boundaries? You couldn’t care less! Changing user expectations? Not your turf! And yet those and other non-IT topics may question your laboriously acquired skills very soon. In this session we will first examine, how those non-IT topics create new forces on software engineering. Based on that we will try to understand the drivers of future IT solutions and how that is going to affect your work – including unraveling the mysteries behind hypes like cloud-native, serverless, APIs, platforms and more. Finally, we will derive what you as a software engineer can do to sustain or even increase your market value in a shifting market, based on a well-balanced combination of new and timeless skills. After the session, besides getting an idea how looking outside-the-box can help you making better decisions inside-the-box you will have a much better idea how to stay ahead of the curve.

Life After Microservices – Shifting the Boundaries

Nordic APIs

This is a session given by Jason Harmon at Nordic APIs 2016 Platform Summit on October 26th, in Stockholm Sweden. Description: Normally, we find valuable data our clients need, and create APIs. We rationalize our domains into understandable resources, with clear boundaries of ownership (especially in microservice environments). However, if our design doesn’t include considerations for how clients will use the APIs, we can get into a lot of trouble when it goes live. We’ll look at some API design patterns that can cause operational headaches, and how to watch out for them. Furthermore, we’ll cover some tricks to get out of trouble if we already have it implemented.

Operational API design anti-patterns (Jason Harmon)

Nordic APIs

API 101 - Understanding APIs

3scale

API Trends: What to expect in 2012

Apigee | Google Cloud

Rest api best practices – comprehensive handbook

Katy Slemon

GitHub Copilot.pptx

Luis Beltran

API Description Languages: Which is the Right One for Me?

Akana

Docs Like Code

Anne Gentle

When you treat docs like code, you multiply everyone’s efforts and streamline processes through collaboration, automation, and innovation. The benefits are real, but these efforts are complex. The ways you can leverage developer process and tools vary widely. Let’s unpack the absolute best situation for using a docs as code model. Then, we can walk through multiple considerations that may point you in one direction or another. We can talk about version control, publishing, REST API considerations, source formats, automation, quality controls and testing, and lessons learned. Let’s study best practices that are outcome-dependent and situational, creating strategic efforts.

Docs Like Code: Strategies and Stories

Anne Gentle

apidays LIVE Paris 2021 - Privacy Engineering by Ian Oliver, Nokia Bell Labs

apidays

Zohar Babin, Senior Director, Ecosystem and Community, Kaltura While a great many API enthusiasts will tell you that achieving API utopia means re-architecting all of your applications (Web, mobile, or otherwise) on top of the same APIs that you make available to external developers, very few organizations have actually succeeded at doing what's necessary; turning their infrastructures inside out. Many organizations can't envision having the time, patience, or resources to fly a plane while the wings are being ripped-off and reinstalled. But open source video platform provider Kaltura pulled it off. As a result, Kaltura's core infrastructure -- back end servers, core applications, etc. --- rely on the same APIs that front-facing partners' applications rely on. The result was a highly flexible future-proof platform that enables customers, partners, developers and startups to rapidly extend the platform with innovative implementations that continuously push the limits of what Kaltura can do. In this presentation, Kaltura willl cover the principles of what makes a great, dogfoodable API, how to make it resilient, future-proof and yet backward compatible, and most importantly how to enable and support customers and partners looking to extend an API platform.

How And Why To Dogfood Your API

ProgrammableWeb

There’s an inherent tension for organizations doing API development: how to keep both your API developers as well as your infrastructure happy, at the same time. Decoupling front-end and back-end development allows parallel development, and helps keep your front-end, middle-end, and back-end efforts working asynchronously. This speeds progress, but requires far more – and far better – collaboration to be successful. Even an independent developer working with APIs requires good collaboration tools. In this talk, Abhinav Asthana will provide tips on how to improve in API development using collaboration tools like executable API descriptions, API mock servers, and documentation. He will include specific examples of how companies (such as VMware, Coursera, and AMC Theatres) have used collaboration to attain more agile development, to onboard developers, and to ensure input from all participants/stakeholders.

Pain Points In API Development? They’re Everywhere

Nordic APIs

This is a session given by Adam Duvander at Nordic APIs 2016 Platform Summit on October 26th, in Stockholm Sweden. Description: API that nobody uses is almost as sad as a pie that nobody eats. Yet, both of these occur every day. Regardless of whether your API is for partners, internal, or external usage, it needs an advocate to help it be adopted. There are good reasons why an API gets no usage, and there’s a lot we can learn from how pies are made, sold, and consumed. Don’t expect short-term tactics, but the timeless fundamentals from Adam DuVander’s lessons learned in developer relations, within a large enterprise, and as one of the earliest journalists covering APIs. You’ll learn the importance of knowing your competition (yup, even for internal APIs), sharing your vision, being ever-present, and helping developers get started fast. And don’t forget the delicious, flaky crust. DuVander has seen the same approach work at database-as-a-service Orchestrate.io, internally at its parent company CTL.io, at his neighborhood bakery, and in discussions with hundreds of API providers over the last eight years.

Pie for Sale: Timeless Lessons in API Advocacy (Adam DuVander)

Nordic APIs

Writers are experts at dealing with ambiguity. We do highly technical work, frequently without formal CS education. We find ways to make content out of wireframes, code strings, Jira tickets, and spit. We especially fall back on these skills when documenting APIs, where the information is often scarce and our understanding of the APIs and how they’re used can feel abstracted from the product. But APIs aren’t just for reference anymore. With an update to our New Relic developer site in the works, we needed to up our game. In February, we hired Chris Cowell to teach members of the Tech Docs and UX teams REST API basics. The class was a huge success because it covered the topics we needed to learn, but also because Chris created a lively, interactive, accessible experience. Even those of us who have been documenting APIs for years came away with deeper understanding and greater confidence. In this talk, Chris Cowell and Michelle Fredette discuss high- and low-level knowledge gaps the training addressed, and how the class has enriched our docs and UX work, as well as our relationships with SMEs. We’ll share some basic tips and finally, we’ll talk about how classes like this one—which a participant called, “the single most effective technical training I’ve ever received”—are fundamental to the expanding complexity of our careers.

Eight Hours to API Literacy: A Fast, Fun On-ramp for Writers

Pronovix

Scaling API Design

Jason Harmon

STC Summit 2015: API Documentation, an Example-Based Approach

Lois Patterson

ProgrammableWeb's eSignature API Research Report

ProgrammableWeb

Tendances (20)

Open Source And the Internet Of Things

Google v Oracle: The Future of Software and Fair Use

API Description Languages

Life After Microservices – Shifting the Boundaries

Operational API design anti-patterns (Jason Harmon)

API 101 - Understanding APIs

API Trends: What to expect in 2012

Rest api best practices – comprehensive handbook

GitHub Copilot.pptx

API Description Languages: Which is the Right One for Me?

Docs Like Code

Docs Like Code: Strategies and Stories

apidays LIVE Paris 2021 - Privacy Engineering by Ian Oliver, Nokia Bell Labs

How And Why To Dogfood Your API

Pain Points In API Development? They’re Everywhere

Pie for Sale: Timeless Lessons in API Advocacy (Adam DuVander)

Eight Hours to API Literacy: A Fast, Fun On-ramp for Writers

Scaling API Design

STC Summit 2015: API Documentation, an Example-Based Approach

ProgrammableWeb's eSignature API Research Report

Similaire à 5 Keys to API Design - API Days Paris 2013

RAML - APIs By Design

Uri Sarid

Mulesoft Raml APIs

akshay yeluru

One of the greatest challenges to developing an API is ensuring that your API lasts. After all, you don’t want to have to release and manage multiple versions of your API just because you weren’t expecting users to use it a certain way, or because you didn’t anticipate far enough down the roadmap. In this session, we’ll talk about the challenge of API Longevity, as well as ways to increase your API lifecycle including having a proper mindset, careful design, agile user experience and prototyping, best design practices including hypermedia, and the challenge of maintaining persistence.

Building a REST API for Longevity

MuleSoft

Building the Eventbrite API Ecosystem

Mitch Colleran

Cloud Services UX

Ross Jimenez

6 Reasons Why APIs Are Reshaping Your Business

Fabernovel

Today, there are many companies that are open to the idea of sharing and actively promote Open Source projects. We, at Neev, not only promote Open Source, but actively utilize Open Source wherever possible in order to increase ROI for customers and decrease time-to-market. It is the best way to give something back to the community. Neev has, from time-to-time, given back to the Open Source community through contributions that aim to solve critical issues faced by the IT community. Here are 18 of our innovative Open Source tools.

Neev Open Source Contributions

Neev Technologies

AWS supports open source. AWS developers have contributed to key projects like Apache MXNet, Gluon API, EKS, and Serverless developer tools. Serverless services like AWS Lambda allow developers to build and run applications without thinking about servers. In 2016, we released an open specification called Serverless Application Model (SAM), a simple configuration file to define Lambda functions and other serverless resources. Since then we have open sourced the underlying implementation of SAM and several other tools to simplify the process of building serverless applications, including SAM Local, a popular CLI tool to run SAM-based applications on a local computer before deploying to the cloud. In this talk, we touch upon the story of open sourcing the SAM toolset. The talk will deep dive into how an open specification has kindled and nurtured an ecosystem of open source projects comprising of serverless examples, reference architectures, libraries, CLIs, and plugins. We will share some success stories of serverless projects like Chalice that went open and matured to become production-grade. We will also discuss the journey of SAM Local CLI from a weekend project to being open source with 6,000 downloads per month, 2,000+ Github Stars, 30+ contributors, and becoming an integral part of the toolchain. The developer community has helped SAM Local CLI work seamlessly on Windows, support APIs defined in Swagger files, improve unit test coverage, and support a lot of important features. The talk will also cover lessons learned and what worked for us in growing the serverless developer community.

Building Open Source Communities for AWS Serverless Developer Tools

Amazon Web Services

The next generation of google APIs (Ade Oshineye)

Ontico

Scaling API Design

Jason Harmon

Scaling API Design - Nordic APIs 2014

Jason Harmon

Building A Great API - Evan Cooke, Cloudstock, December 2010

Twilio Inc

Ian Jennings presents at the Austin UXPA meetup on November 12, 2019 at Visa. Developer Experience (DX) is the equivalent to User Experience (UX) when the user of the software or system is a developer. Sure, the science is the same, but this talk will teach you why developer experience is gaining traction as a new field. Between APIs, SDKs, code, documentation, demos, CLIs, tutorials, and developer portals, DX is a whole new beast. Learn about the emergence of Developer Experience, the similarities and differences between UX an DX, and the tools you need to apply your UX experience toward the field of DX. Speaker Bio: Ian Jennings is the founder of Haxor, a developer experience testing platform based in Austin TX. Haxor tests and measures APIs, SDKs, and developer products with on-demand feedback from real developers. Previously Ian co-founded developer meetup platform Hacker League (acquired by Mashery and Intel) before spending 6 years at PubNub establishing their developer experience strategy. He also operates DevPort, a developer portfolio site populated by thousands of developers.

Developer Experience (DX) for UX Professionals

Ian Jennings

APIs as a Product Strategy

Ravi Kumar

Mobile apps have been proven to be the best way for companies to increase their customer base. There have been many innovative app ideas. App development businesses were vital to ensuring that everything worked. You can be proficient in simple computer languages to create an app. There are many platforms that allow you to develop apps for iOS and Android. You only need to grasp web-based programming languages such as HTML, CSS, or JavaScript. Swiftic has been voted by one of the top mobile app development company for best tools on the iOS platform.

Popular App Development Frameworks used by App Developers.

Techugo

OS Accelerate London - 09/16/15

Appnovation Technologies

Reaching 1 Million APIs and what to do when we get there

3scale

Six Principles of Software Design to Empower Scientists

David De Roure

Ronnie Mitra's slides from the Layer 7 Munich API Management Workshop. This workshop will included talks from Softcon CTO Michel Dorochevsky and Layer 7 API Architect Ronnie Mitra. The workshop Covered: • Discover the latest trends in the API economy • Understand why API Management is important • Learn best practices for securely exposing your APIs • Find out what other organizations are doing to manage their APIs

API Introduction - API Management Workshop Munich from Ronnie Mitra

CA API Management

API Description Languages: Which Is The Right One For Me?

ProgrammableWeb

Similaire à 5 Keys to API Design - API Days Paris 2013 (20)

RAML - APIs By Design

Mulesoft Raml APIs

Building a REST API for Longevity

Building the Eventbrite API Ecosystem

Cloud Services UX

6 Reasons Why APIs Are Reshaping Your Business

Neev Open Source Contributions

Building Open Source Communities for AWS Serverless Developer Tools

The next generation of google APIs (Ade Oshineye)

Scaling API Design

Scaling API Design - Nordic APIs 2014

Building A Great API - Evan Cooke, Cloudstock, December 2010

Developer Experience (DX) for UX Professionals

APIs as a Product Strategy

Popular App Development Frameworks used by App Developers.

OS Accelerate London - 09/16/15

Reaching 1 Million APIs and what to do when we get there

Six Principles of Software Design to Empower Scientists

API Introduction - API Management Workshop Munich from Ronnie Mitra

API Description Languages: Which Is The Right One For Me?

Dernier

Advantages of Hiring UIUX Design Service Providers for Your Business

Pixlogix Infotech

Three things you will take away from the session: • How to run an effective tenant-to-tenant migration • Best practices for before, during, and after migration • Tips for using migration as a springboard to prepare for Copilot in Microsoft 365 Main ideas: Migration Overview: The presentation covers the current reality of cross-tenant migrations, the triggers, phases, best practices, and benefits of a successful tenant migration Considerations: When considering a migration, it is important to consider the migration scope, performance, customization, flexibility, user-friendly interface, automation, monitoring, support, training, scalability, data integrity, data security, cost, and licensing structure Next Wave: The next wave of change includes the launch of Copilot, which requires businesses to be prepared for upcoming changes related to Copilot and the cloud, and to consolidate data and tighten governance ShareGate: ShareGate can help with pre-migration analysis, configurable migration tool, and automated, end-user driven collaborative governance

Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff

sammart93

Scaling API-first – The story of a global engineering organization

Radu Cotescu

This presentations targets students or working professionals. You may know Google for search, YouTube, Android, Chrome, and Gmail, but did you know Google has many developer tools, platforms & APIs? This comprehensive yet still high-level overview outlines the most impactful tools for where to run your code, store & analyze your data. It will also inspire you as to what's possible. This talk is 50 minutes in length.

Powerful Google developer tools for immediate impact! (2023-24 C)

wesley chun

What is a good lead in your organisation? Which leads are priority? What happens to leads? When sales and marketing give different answers to these questions, or perhaps aren't sure of the answers at all, frustrations build and opportunities are left on the table. Join us for an illuminating session with Cian McLoughlin, HubSpot Principal Customer Success Manager, as we look at that crucial piece of the customer journey in which leads are transferred from marketing to sales.

04-2024-HHUG-Sales-and-Marketing-Alignment.pptx

HampshireHUG

Enterprise Knowledge’s Urmi Majumder, Principal Data Architecture Consultant, and Fernando Aguilar Islas, Senior Data Science Consultant, presented "Driving Behavioral Change for Information Management through Data-Driven Green Strategy" on March 27, 2024 at Enterprise Data World (EDW) in Orlando, Florida. In this presentation, Urmi and Fernando discussed a case study describing how the information management division in a large supply chain organization drove user behavior change through awareness of the carbon footprint of their duplicated and near-duplicated content, identified via advanced data analytics. Check out their presentation to gain valuable perspectives on utilizing data-driven strategies to influence positive behavioral shifts and support sustainability initiatives within your organization. In this session, participants gained answers to the following questions: - What is a Green Information Management (IM) Strategy, and why should you have one? - How can Artificial Intelligence (AI) and Machine Learning (ML) support your Green IM Strategy through content deduplication? - How can an organization use insights into their data to influence employee behavior for IM? - How can you reap additional benefits from content reduction that go beyond Green IM?

Driving Behavioral Change for Information Management through Data-Driven Gree...

Enterprise Knowledge

Automating Google Workspace (GWS) & more with Apps Script

wesley chun

Tata AIG General Insurance Company - Insurer Innovation Award 2024

The Digital Insurer

Join our latest Connector Corner webinar to discover how UiPath Integration Service revolutionizes API-centric automation in a 'Quote to Cash' process—and how that automation empowers businesses to accelerate revenue generation. A comprehensive demo will explore connecting systems, GenAI, and people, through powerful pre-built connectors designed to speed process cycle times. Speakers: James Dickson, Senior Software Engineer Charlie Greenberg, Host, Product Marketing Manager

Connector Corner: Accelerate revenue generation using UiPath API-centric busi...

DianaGray10

Effective data discovery is crucial for maintaining compliance and mitigating risks in today's rapidly evolving privacy landscape. However, traditional manual approaches often struggle to keep pace with the growing volume and complexity of data. Join us for an insightful webinar where industry leaders from TrustArc and Privya will share their expertise on leveraging AI-powered solutions to revolutionize data discovery. You'll learn how to: - Effortlessly maintain a comprehensive, up-to-date data inventory - Harness code scanning insights to gain complete visibility into data flows leveraging the advantages of code scanning over DB scanning - Simplify compliance by leveraging Privya's integration with TrustArc - Implement proven strategies to mitigate third-party risks Our panel of experts will discuss real-world case studies and share practical strategies for overcoming common data discovery challenges. They'll also explore the latest trends and innovations in AI-driven data management, and how these technologies can help organizations stay ahead of the curve in an ever-changing privacy landscape.

TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery

TrustArc

Imagine a world where information flows as swiftly as thought itself, making decision-making as fluid as the data driving it. Every moment is critical, and the right tools can significantly boost your organization’s performance. The power of real-time data automation through FME can turn this vision into reality. Aimed at professionals eager to leverage real-time data for enhanced decision-making and efficiency, this webinar will cover the essentials of real-time data and its significance. We’ll explore: FME’s role in real-time event processing, from data intake and analysis to transformation and reporting An overview of leveraging streams vs. automations FME’s impact across various industries highlighted by real-life case studies Live demonstrations on setting up FME workflows for real-time data Practical advice on getting started, best practices, and tips for effective implementation Join us to enhance your skills in real-time data automation with FME, and take your operational capabilities to the next level.

From Event to Action: Accelerate Your Decision Making with Real-Time Automation

Safe Software

Real Time Object Detection Using Open CV

Khem

This presentation explores the impact of HTML injection attacks on web applications, detailing how attackers exploit vulnerabilities to inject malicious code into web pages. Learn about the potential consequences of such attacks and discover effective mitigation strategies to protect your web applications from HTML injection vulnerabilities. for more information visit https://bostoninstituteofanalytics.org/category/cyber-security-ethical-hacking/

HTML Injection Attacks: Impact and Mitigation Strategies

Boston Institute of Analytics

Strategies for Landing an Oracle DBA Job as a Fresher

Remote DBA Services

Partners Life - Insurer Innovation Award 2024

The Digital Insurer

Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024

The Digital Insurer

How to Troubleshoot Apps for the Modern Connected Worker

ThousandEyes

Developing An App To Navigate The Roads of Brazil

V3cube

Scaling API-first – The story of a global engineering organization Ian Reasor, Senior Computer Scientist - Adobe Radu Cotescu, Senior Computer Scientist - Adobe Apidays New York 2024: The API Economy in the AI Era (April 30 & May 1, 2024) ------ Check out our conferences at https://www.apidays.global/ Do you want to sponsor or talk at one of our conferences? https://apidays.typeform.com/to/ILJeAaV8 Learn more on APIscene, the global media made by the community for the community: https://www.apiscene.io Explore the API ecosystem with the API Landscape: https://apilandscape.apiscene.io/

Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe

apidays

Created by Mozilla Research in 2012 and now part of Linux Foundation Europe, the Servo project is an experimental rendering engine written in Rust. It combines memory safety and concurrency to create an independent, modular, and embeddable rendering engine that adheres to web standards. Stewardship of Servo moved from Mozilla Research to the Linux Foundation in 2020, where its mission remains unchanged. After some slow years, in 2023 there has been renewed activity on the project, with a roadmap now focused on improving the engine’s CSS 2 conformance, exploring Android support, and making Servo a practical embeddable rendering engine. In this presentation, Rakhi Sharma reviews the status of the project, our recent developments in 2023, our collaboration with Tauri to make Servo an easy-to-use embeddable rendering engine, and our plans for the future to make Servo an alternative web rendering engine for the embedded devices industry. (c) Embedded Open Source Summit 2024 April 16-18, 2024 Seattle, Washington (US) https://events.linuxfoundation.org/embedded-open-source-summit/ https://ossna2024.sched.com/event/1aBNF/a-year-of-servo-reboot-where-are-we-now-rakhi-sharma-igalia

A Year of the Servo Reboot: Where Are We Now?

Igalia

Dernier (20)

Advantages of Hiring UIUX Design Service Providers for Your Business

Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff

Scaling API-first – The story of a global engineering organization

Powerful Google developer tools for immediate impact! (2023-24 C)

04-2024-HHUG-Sales-and-Marketing-Alignment.pptx

Driving Behavioral Change for Information Management through Data-Driven Gree...

Automating Google Workspace (GWS) & more with Apps Script

Tata AIG General Insurance Company - Insurer Innovation Award 2024

Connector Corner: Accelerate revenue generation using UiPath API-centric busi...

TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery

From Event to Action: Accelerate Your Decision Making with Real-Time Automation

Real Time Object Detection Using Open CV

HTML Injection Attacks: Impact and Mitigation Strategies

Strategies for Landing an Oracle DBA Job as a Fresher

Partners Life - Insurer Innovation Award 2024

Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024

How to Troubleshoot Apps for the Modern Connected Worker

Developing An App To Navigate The Roads of Brazil

Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe

A Year of the Servo Reboot: Where Are We Now?

5 Keys to API Design - API Days Paris 2013

1. 5 Keys to API Design Daniel Feist @dfeist Principal Architect, MuleSoft @MuleSoft

2. Me?

3. Me?

4. Me?

5. Me?

6. APIs: The Cat's Meow

8. The New Enterprise SaaS Cloud platforms Social Mobility and Devices Customers / Partners / Suppliers Packaged apps Custom apps Big Databases / Big Files

9. The New Enterprise 1,000s 100s SaaS Cloud platforms Social 1,000,000,000s 100,000s Mobility and Devices Customers / Partners / Suppliers Packaged apps 1,000,000s Custom apps Big Databases / Big Files

10. The New Enterprise SaaS Social Cloud platforms Open web APIs Mobility and Devices Customers / Partners / Suppliers B2B APIs Product APIs Internal APIs Packaged apps Custom apps The New Enterprise Databases

11. API Design

12. #1 The Contract is Critical

13. The API Contract Is Critical •  tells consumer devs what they'll get •  tells implementer devs what to deliver •  enables parallel development •  ensures they'll meet in the end

14. The Contract is Critical ü  where consumers touch you ü  your front door, your lobby, your façade ü  how you want to be seen; your brand ü  versioned more carefully than code ü  better interfaces è better code ü  an organizing principle; alignment forcing function ü  the ultimate testing surface

15. What kind of contract do we want? 1.  Describe APIs simply and clearly 2.  Design APIs easily and soundly

16. What kind of contract do we want? Document your API? or Model your API?

17. #2 Design to Delight

18. The Key to API Success? how? •  •  •  •  design for them iterate quickly model cleanly and consistently gather feedback

19. #3 Think APX not API

20. Design For Your Users UI à UX Valida te API à APX Capture Feedback

21. Think APX! This is a long-lived interface, ladies and gentlemen Don't expose dirty laundry ! users products orders è invoices Craft it for your users: what will they love?

22. #4 Use Patterns

23. Pattern Lifecycle Define Share Reuse

24. Types of Patterns •  Resource Types •  Collection •  Collection Member •  Document •  Traits •  Secure •  Paged

25. #5 Engage Developers

26. Engage Developers •  Social Tools •  Rate, discuss •  Provide feedback •  Interactive Console •  Prototyping Tools

27.

28. What Do People Do Today?

29. WADL

30. Reverb Swagger

31. Mashery IOdocs

32. Google Discovery Docs

33. Apiary Blueprint

34. Verdict: manifest structure capture patterns humanly writeable let's try harder…

35. Start From Scratch? Really???

36. No Need to Start From Scratch! •  •  •  •  •  •  well-known superset of JSON optimized for human readability great for hierarchies cruft-free broad tooling base extensible-ish

37. RAML RESTful API Modeling Language A new open spec for RESTful APIs that's as clean and as structured as REST itself the RAML Workgroup: raml.org

38. RAML: How Clean? How Structured?

39. RAML: Clean & Structured.

40. RAML: Reuse resource type schema trait

41. Covers Full HTTP optional version in baseUri template URIs query parameters headers (on request and response) response per status code example (and schema) per media type

42. Patterns: Resource Types externalizable inheritance pull in traits parametrize

43. Patterns: Method-level traits mix-ins

44. Patterns: body schemas XML schema JSON schema or just use good ol' form data: examples

45. Patterns: security schemes username/password; cleartext or use digest end user allows app to access their data better to put token in header, not query the OAuth multi-step dance

46.

47. What's next? q growing library of API specs in RAML (e.g. on APIhub) q converters (import WADL, Swagger etc.) q client generators q server frameworks (e.g. MuleSoft APIkit; node.js) q JAX-RS Support q testing frameworks q mocking services (e.g. on APIhub) q <insert your ideas here> q evolve RAML spec (RAML workgroup)

48.

49. Interesting?

50. Thank you!

5 Keys to API Design - API Days Paris 2013

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

Similaire à 5 Keys to API Design - API Days Paris 2013

Similaire à 5 Keys to API Design - API Days Paris 2013 (20)

Dernier

Dernier (20)

5 Keys to API Design - API Days Paris 2013