Verantwortungsvolle APIs

Slide 1

Slide 1 text

Slide 2

Slide 2 text

André Cedik Developer Advocate & Software Developer shipcloud GmbH @andrecedik

Slide 3

Slide 3 text

The road so far

Slide 4

Slide 4 text

Shitstorm Incoming

Slide 5

Slide 5 text

Breaking Change • macht Euch der Implikationen bewusst, die Eure Entscheidungen haben • auch kleine Änderungen können große Auswirkungen haben

Slide 6

Slide 6 text

Jumping Through Hoops • Änderungen klar kommunizieren • zusätzliche Hürden (z.B. Freischaltung) beseitigen

Slide 7

Slide 7 text

Code Qualität

Slide 8

Slide 8 text

Default-Werte • API muss eindeutig sein • Fallbacks vermeiden • keine Seiteneffekte

Slide 9

Slide 9 text

Konsistenz erreichen • frühzeitig Edge Cases identiﬁzieren • API-Nutzer vor Seiteneffekten externer Schnittstellen schützen

Slide 10

Slide 10 text

Feed your own dogfood • API auch in Browser-Applikation nutzen (sofern angeboten) • Side Projects auf Basis der eigenen Lösung

Slide 11

Slide 11 text

Ship it! • Release often & early • Feature Toggles nutzen • Pre-Release Code in kleinen Teilen

Slide 12

Slide 12 text

Get Feedback • VIP-Kunden identiﬁzieren und für Test von neuen Features einbinden • Tinker in Side Projects & Hackathons

Slide 13

Slide 13 text

Frühzeitig Gedanken   über v2 machen • Übersichtlichkeit erreichen • Kommunikation gegenüber Partnern & Kunden erarbeiten

Slide 14

Slide 14 text

Gute Dokumentation • Swagger, RAML, etc. • In-Code-Doku (z.B. über Annotationen) • Documentation Driven Design • OpenSource • Changelog pﬂegen

Slide 15

Slide 15 text

Spread the love

Slide 16

Slide 16 text

Affiliate Programme • auf Monetarisierung achten • nachhaltige Incentives schaffen

Slide 17

Slide 17 text

Offenheit • Statusseite • Downtimes / Maintenance • Weiterverteilung über Zielgruppen speziﬁsche Kanäle

Slide 18

Slide 18 text

Vorlaufzeit für Integrationspartner • in Roadmap einbinden • mit nötigen Rechten versorgen • ggf. gemeinsames Marketing betreiben

Slide 19

Slide 19 text

Make it easy • einfache API, ohne Seiteneffekte / Sonderlocken • gute Dokumentation • offen / ansprechbar sein

Slide 20

Slide 20 text

"APIs are a long commitment. Once you build them, they take time for developers to adopt and grow into revenue. You don’t put your enterprise sales team in the field and start closing $10M deals on launch day. You seed developers with ideas, you help them find use cases, and after developers build, you watch their apps go from prototypes, to betas, to production systems with happy customers. It requires patience and deep commitment, but when developers succeed with your API, you succeed." Jeff Lawson Twilio CEO & Co-Founder

Slide 21

Slide 21 text

André Cedik Developer Advocate & Software Developer