This talk was hosted during the Developer Week 2019 conference. I attended this talk to satisfy my curiosity for how Eventbrite has evolved.
This talk was different than the other talks. This one was a discussion between Romain Huet (Head of Global Developer Relation at Stripe) and Renaud Visage (Technical Co-Founder of Eventbrite).
Integration is not about checking the box, it is how truly integrated and connected the systems are.
When building a product, one must keep in mind the end goal and how the product will turn. If product is prioritized then apis are built, the apis will be second class citizen. However, if APIs are designed first and then implemented into the product, it makes things easier to open up to the public.
Another thing to keep in mind is future proof apis. Once a single user starts using the API it is extremely difficult to change it (especially if dealing with payment processing aka. Stripe).
Finally, do things that don't scale first! Always offer help and learn from the customer before scaling and becoming hands off. This ensures you don't spend time and resources scaling something that will need to be revamped once the customer starts using it. Find the right partners to help build the platform (expose the apis).
When it comes to documentation most users/developers don't want data! They want workflows, actions, defined processes and examples. Define benefits and approaches for customers.
API documentation should be treated like a product. Do user interviews, ensure documentation are accurate, provide training and iterate. Integration experience should be measured using Time to first API call.
Eventbrite started exposing data using RSS feeds.