All Posts By

Jeff ErnstFriedman

The OpenAPI Initiative’s Technical Steering Committee Releases OASv3.0.2

By | Blog

The members of the OpenAPI Initiative Technical Steering Committee have announced the latest release of OpenAPI Specification 3.0.2. Note: This release is a patch release and none of these modifications change the behavior of the spec.

As a patch release, the latest changes were made to improve the specification in terms of readability and accuracy. Please read the release notes on on our GitHub repo here.

If you are interested in getting involved in the development of the spec, join us Thursday’s at 9a.m. Pacific for the public, open meetings of the Technical Steering Committee.

  • Added clarification to case sensitivity of keys in maps.
  • Reworked the Data Type table, removing the Common Name to reduce potential confusion.
  • Clarified the description of the Server Variable Object’s default field.
  • Fixed various examples.
  • Clarified operationId is case sensitive.
  • Clarified the default value of the Parameter Object’s deprecated field is false.
  • Added recommendation to not use the Parameter Object’s allowEmptyValue field as it will be removed in a future version.
  • Fixed the description of the Media Type Object’s schema field.
  • Clarified the description of the Responses Object’s response codes field description.
  • Clarified that the Schema Object’s additionalProperties field has a default value of true.
  • Fixed a small wording issue in the Discriminator Object description.
  • Fixed the Security Scheme Object description to include reference to the use of API Keys in cookies.
  • Fixed the description of the Security Requirement Object.

The Top Reasons to Attend the API Conference of the Year

By | Blog

The API Strategy & Practice Conference, known as APIStrat, is a conference focused on the API economy, and brings together experts, leaders, and members of the community to discuss what we each see on the ground every day. Happening September 24 – 26 in Nashville, Tennessee this is a conference you don’t want to miss.

We wanted to bring you the top reasons why we think you should attend the event. AND if you register today (September 14), you will save an addition $200 off of the conference. Don’t wait!

Here are the top reasons you’ll want to be at this event:

 

  1. New Trends and Innovation in the API Space and Beyond: Along with learning the latest trends in the API space, you will also hear from speakers providing an expanded perspective of the technology world we live in today, including keynotes Virginia Eubanks, Associate Professor of Political Science at the University at Albany, SUNY discussing Automating Inequality: How High-Tech Tools Profile, Police and Punish the Poor and Kate O’Neill, author of Pixels and Place and lead at KO Insights, discussing Tech Humanism: Integration, Automation, and the Future of the Human Experience.
  2. Learn about best practices in the API space: The conference will uncover best practices when it comes to APIs as products, API portals, API design, and API usability. A few keynotes and talks include transforming the enterprise to an API platform; microservicing like a unicorn with Envoy, Istio and Kubernetes; and Evolving API: designing while requirements are still in flux. Come to the event and take away ideas that you can use right away!
  3. Nashville, Tennessee: The music city of America has a lot of amazing things to do, see, and eat! There’s the classics like the Grand Ole Opry, Country Music Hall of Fame and The Station Inn for bluegrass music. Of course, there’s also plenty of fun walking tours if you are into food, drink, music, history and ghosts (every town has to have one)! Nashville is definitely a city on most folks bucket list, so get it checked off and attend an awesome conference too. And maybe you’ll even discover a rising star if you hit The Listening Room Cafe.
  4. Hands-on workshops: If you are the type of person who learns by doing, there are a lot of amazing hands-on workshops that you can join from practical SecDevOps for APIs to turning external services into internal APIs. Whether you are an experienced API practitioner or just getting started, there’s a workshop for you.
  5. Social Activities and Networking: One of the top choices to attend this event or any Linux Foundation event are the social activities that are provided to you, like our fun run (you can walk or jog too). Plus, this is a great place to network with your peers, many rate the hallway tracks at APIStrat as one of the top reasons to attend year after year.
  6. Diversity and Inclusion: We want to make sure everyone feels welcome and safe at our conferences. We offer special items like a quiet room if you need a physical space where conversation and interaction is not allowed, a nursing room and child care as well as special communication stickers, and other features to make this event as accessible as possible.
  7. OAS workshop: Among the awesome workshops that we have, we are also hosting a pair of unique OAS workshops. The beginner workshop is a hands-on introduction to the OpenAPI Specification 3.0. Directly following the intro session will be the OAS advanced users’ workshop and will conclude with what features are on the horizon. Attendees of these workshops will leave with a working knowledge of OASv3 which has become the defacto standard for describing APIs.

See the full lineup of speakers here and the register here.

Advanced OpenAPI Specification Technical Overview/Workshop at APIStrat 2018

By | Blog

Please join us for an advanced hands-on workshop on OpenAPI 3.0. Be sure to bring your own laptop to participate. This will be an OpenAPI Specification Technical Overview/Workshop.

A hands-on training session with more advanced features and 3.0 specific features, suitable for developers who already know v2 and want to know what’s new in the current version. Ends with a preview of the future release.

You will learn about:

  1. Schema Objects
  2. External References
  3. Form Data
  4. Links and Callbacks
  5. Security Schemes
  6. XmlExample
Ron Ratovsky
Swagger Developer Evangelist, SmartBear
Ron is the technical liason for the OpenAPI Initiative's Technical Steering Committee
Ted Epstein
RepreZen CEO
Ted Epstein, CEO of RepreZen, has been helping organizations succeed with API strategy and architecture for over 10 years. Ted participates in the OpenAPI Technical Design Community as a governing board member, and leads the architecture of RAPID-ML, the first API description language to bring the power of Domain-Driven Design to REST APIs. Ted is co-organizer of the API-Craft NYC Meetup and speaks at conferences including QCon, EclipseCon, APIStrat, API-Craft, and Data Modeling Zone.
Emmanuel Paraskakis
Sr. Director of Product Management, Oracle API Platform
Emmanuel has been working on delivering APIs for customers for over a decade and is a passionate member of the API Community. The last three years he has been crafting API tooling as part of Apiary, recently acquired by Oracle. Currently, he is heading up Product Management for Oracle’s API Platform, a full lifecycle suite of products for API Providers and Consumers. He is also the organizer for the API Craft San Francisco Meetup Group with over 1,000 members.

Intro Level OpenAPI Specification Technical Overview/Workshop at APIStrat 2018

By | Blog

Please join us for a hands-on workshop on OpenAPI 3.0 at APIStrat 2018 in Nashville on Sept. 24. You can drop-in for this session only or stay for the advanced workshop right after.  Be sure to bring your own laptop to participate. This will be an OpenAPI Specification Technical Overview/Workshop – A hands-on training session introducing essential capabilities of OpenAPI and its most commonly used features.

You will learn:

  1. What’s OpenAPI 3.0
  2. OpenAPI and Server Objects
  3. Paths and Path Parameters
  4. GET Operation and Responses
  5. Query and Header Parameters
  6. POST, PATCH, and PUT
  7. Documentation with markdown

Ron Ratovsky
Swagger Developer Evangelist, SmartBear
Ron is the technical liason for the OpenAPI Initiative's Technical Steering Committee
Ted Epstein
RepreZen CEO
Ted Epstein, CEO of RepreZen, has been helping organizations succeed with API strategy and architecture for over 10 years. Ted participates in the OpenAPI Technical Design Community as a governing board member, and leads the architecture of RAPID-ML, the first API description language to bring the power of Domain-Driven Design to REST APIs. Ted is co-organizer of the API-Craft NYC Meetup and speaks at conferences including QCon, EclipseCon, APIStrat, API-Craft, and Data Modeling Zone.
Emmanuel Paraskakis
Sr. Director of Product Management, Oracle API Platform
Emmanuel has been working on delivering APIs for customers for over a decade and is a passionate member of the API Community. The last three years he has been crafting API tooling as part of Apiary, recently acquired by Oracle. Currently, he is heading up Product Management for Oracle’s API Platform, a full lifecycle suite of products for API Providers and Consumers. He is also the organizer for the API Craft San Francisco Meetup Group with over 1,000 members.

Convincing Your Boss to Send You to APIStrat

By | Blog

At API Strategy and Practice – better known as APIStrat – *brings together everyone – from the API curious to today’s leaders – to discuss opportunities and challenges in the API space. APIStrat sparks conversations between API providers and API consumers, startups and enterprise, developers and architects, and all types of integrators.* The event covers a broad spectrum of the API lifecycle as well as best practices around progressive web apps, the offline-first approach, and stories from end-users. This conference hosted by the OpenAPI Initiative, curators of the de facto standard in API design: OpenAPI Specification includes talks on Kubernetes, GraphQL, RPC, JSON, Microservices, Hypermedia and how best to implement them.

We understand that you are busy and may not have the time or just don’t know what to say to your boss around the importance of sending you to this conference. Not to fret. We’ve created an email template for you to use. Feel free to use the full letter or pieces of it, and let us know if it helped you get to the conference!

________________________________

Hi {Boss’ Name},

I’d like to attend APIStrat taking place Sept. 24–26 in Nashville, TN. Vendor-neutral by design, the conference offers case studies, panels, session presentations and lightning talks that tap into emerging trends in API architecture and implementation, with a keen interest in material that provides clarity on the rapidly evolving, sometimes complex, landscape.

The track(s) that will benefit our business the most include {Insert Most Appropriate Track: accessibility, application development and APIs, artificial intelligence and machine learning, community and developers, serverless, internationalization, IoT, performance, progressive web apps, security, standards, testing tools and infrastructure}. You can view the full schedule here.

Additional topics/benefits of the conference include:

The event costs $599 through September 14. I would be happy to write a post-conference report and share with other members of the team on what I’ve learned and how we can implement tools and techniques into our business strategy.

Thanks,

{Your Name}

Something for Everyone at APIStrat 2018

By | Blog

APIStrat 2018 is just a month away and I could not be more excited for the lineup we have this year! The program committee did another exceptional job in bringing in a wide range of topics and speakers, opening up opportunities for practitioners across not only the entirety of the API lifecycle but all levels of technical expertise as well. Register before September 14 and save $200 off your conference fee. Come on down to Nashville for the premier API event of the year.

As we all know, there is not an industry or vertical that does not consume APIs in some form or fashion. Because of the broad scope of APIs that means every company should want to be a part of the conversation of what is happening next in APIs. At APIStrat, you can learn directly from the people designing the next evolution of the OpenAPI Spec and the tooling ecosystem it supports.

Review the schedule by topic

Join Jenn Schiffer at APIStrat 2018

By | Blog

Join the OpenAPI Initiative and hundreds of API developers, strategist and thought leaders for APIStrat 2018 on Sept. 24-26 in Music City.

APIStrat brings together everyone – from the API curious to today’s leaders – to discuss opportunities and challenges in the API space. APIStrat sparks conversations between API providers and API consumers, startups and enterprise, developers and architects, and all types of integrators.

KEYNOTE SPOTLIGHT: Jenn Schiffer


Jenn Schiffer is an engineer, artist and tech humorist. Most people know her for her incredible strength and also for being the Community Engineer of http://Glitch.com at Fog Creek. She organizes JerseyScript, a monthly web developer social in Jersey City where she’s based, and built everyone’s favorite free online pixel art editor, http://Make8BitArt.com .

REGISTER TODAY

Whether your business consumes or produces APIs, this conference is the best opportunity to interact with the companies and developers who are pushing the envelope in API implementation.

We look forward to seeing you in Nashville

Join Cristiano Betts at APIStrat 2018

By | Blog

Join the OpenAPI Initiative and hundreds of API developers, strategist and thought leaders for APIStrat 2018 on Sept. 24-26 in Music City.

APIStrat brings together everyone – from the API curious to today’s leaders – to discuss opportunities and challenges in the API space. APIStrat sparks conversations between API providers and API consumers, startups and enterprise, developers and architects, and all types of integrators.

KEYNOTE SPOTLIGHT: Cristiano Betta

Cristiano is a Developer Experience designer who helps companies small and large to improve their developer onboarding, activation, and support. He likes to look at great developer onboarding flows, analysing and documenting the best practices and pitfalls of common design practices. Although he has over 15 years of development experience he believes that at the core we’re all beginners at some things, and documentation and onboarding should reflect that notion. In the past he’s worked as a contractor, startup founder, event organiser, and developer advocate at PayPal.

REGISTER TODAY

Whether your business consumes or produces APIs, this conference is the best opportunity to interact with the companies and developers who are pushing the envelope in API implementation.

We look forward to seeing you in Nashville

Join Virginia Eubanks at APIStrat 2018

By | Blog

Join the OpenAPI Initiative and hundreds of API developers, strategist and thought leaders for APIStrat 2018 on Sept. 24-26 in Music City.

APIStrat brings together everyone – from the API curious to today’s leaders – to discuss opportunities and challenges in the API space. APIStrat sparks conversations between API providers and API consumers, startups and enterprise, developers and architects, and all types of integrators.

KEYNOTE SPOTLIGHT: Virginia Eubanks

Virginia Eubanks is an Associate Professor of Political Science at the University at Albany, SUNY. She is the author of Automating Inequality: How High-Tech Tools Profile, Police, and Punish the Poor; Digital Dead End: Fighting for Social Justice in the Information Age; and co-editor, with Alethia Jones, of Ain’t Gonna Let Nobody Turn Me Around: Forty Years of Movement Building with Barbara Smith. Her writing about technology and social justice has appeared in The American Prospect, The Nation, Harper’s and Wired. For two decades, Eubanks has worked in community technology and economic justice movements. Today, she is a founding member of the Our Data Bodies Project and a Fellow at New America. She lives in Troy, NY.

 

 

 

REGISTER TODAY

Whether your business consumes or produces APIs, this conference is the best opportunity to interact with the companies and developers who are pushing the envelope in API implementation.

We look forward to seeing you in Nashville

Join Kate O’Neill at APIStrat 2018

By | Blog

Join the OpenAPI Initiative and hundreds of API developers, strategist and thought leaders for APIStrat 2018 on Sept. 24-26 in Music City.

APIStrat brings together everyone – from the API curious to today’s leaders – to discuss opportunities and challenges in the API space. APIStrat sparks conversations between API providers and API consumers, startups and enterprise, developers and architects, and all types of integrators.

KEYNOTE SPOTLIGHT: Kate O’Neill

Kate O’Neill, “tech humanist,” is founder and CEO of KO Insights, an award-winning thought leadership and advisory firm helping companies, organizations, and cities make future-aligned meaningful decisions based on human behavior and data. Author of 3 books including PIXELS AND PLACE: Connecting Human Experience Across Physical and Digital Spaces, Kate speaks regularly at industry conferences and private events, providing keynotes, participating in panel discussions, and leading creative brainstorming workshops for groups of all sizes. Her expertise has been featured in CNN Money, TIME, Forbes, USA Today, Men’s Journal, the BBC, and other national and international media. Kate’s prior roles include creating the first content management role at Netflix, leading cutting-edge online optimization work at Magazines.com, developing Toshiba America’s first intranet, building the first departmental website at the University of Illinois at Chicago, and holding leadership positions in a variety of digital content and technology start-ups. She was also founder & CEO of [meta]marketer, a digital strategy and analytics agency. Kate is a vocal and visible advocate for women in technology, entrepreneurship, and leadership — she was featured by Google in the launch of their global campaign for women in entrepreneurship.

REGISTER TODAY

Whether your business consumes or produces APIs, this conference is the best opportunity to interact with the companies and developers who are pushing the envelope in API implementation.

We look forward to seeing you in Nashville