OpenStack Summit May 2015 Vancouver has ended
Back To Schedule
Tuesday, May 19 • 12:05pm - 12:45pm
The Good and the Bad of the OpenStack REST APIs

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

As a relatively recent new user of OpenStack, I have mixed feelings about the current state of the OpenStack APIs. On one side, it is exciting to see how modular OpenStack is, how each module sports its own REST API, and how all of these APIs can interact and function together. But also, I can't help but notice that there are inconsistencies in the design of these various APIs, and that best practices associated with REST architecture are frequently ignored or violated.

The inconsistencies among the different APIs concern me very much. To help improve the situation, I have been an active member of the API Working Group since its inception. In this talk I want to share my personal views and pre-OpenStack experiences on REST API design, and contrast that to the state of the OpenStack APIs. Drawing from the reviews and discussions in the API Working Group, I plan to show actual examples of what I perceive are the problem areas. I'll be joined by one of the founding members of the API Working Group to talk about what we're doing to improve the APIs and the overall developer experience for users building applications and tools on OpenStack.

More specifically, the topics we'll cover are:

  • APIs vs. Web APIs vs. REST APIs. What's the difference?

  • The Good
    • Stateless servers

    • Modular APIs

    • Authentication

  • The Bad
    • Inconsistencies: pagination, sorting, searching. metadata handling

    • Actions vs. Resources

    • Lack of hypermedia

    • Client/Server coupling

  • OpenStack clients vs. OpenStack APIs

  • The API Working Group
    • Purpose

    • Scope

    • Guidelines

I hope by the end of the session you will have another perspective to consider when building applications and tools on the OpenStack APIs.

avatar for Miguel Grinberg

Miguel Grinberg

Software Developer at Rackspace
Miguel Grinberg is a Software Developer with Rackspace. He is the author of the O'Reilly book "Flask Web Development", and has a blog at http://blog.miguelgrinberg.com, where he writes about a variety of topics including web development, Python, robotics, photography and the occasional... Read More →
avatar for Everett Toews

Everett Toews

Developer Advocate
I'm a Developer Advocate at Rackspace making OpenStack and the Rackspace Cloud easy to use for developers and operators. Sometimes developer, sometimes advocate, and sometimes operator. In the past I've developed web applications, deployed OpenStack, taught workshops at conferences... Read More →

Tuesday May 19, 2015 12:05pm - 12:45pm PDT
Room 202/203/204

Attendees (0)