Box API v2: Less is More

Box has updated their API to version 2 and has simplified it along the way. The highlights:

  • Consistent request/response models
  • Convention-based attribute names (please do this in your APIs)
  • No more XML, huzzah!
  • Better events streams (I hope that Webhooks follows)
  • Settled on OAuth2 standard

My favorite line:

There’s an inherent impedance mismatch between XML and regular humans.

These are all very developer-friendly changes. If you’re designing an API, there’s a lot to learn from Box’s experience.