apidays Paris 2024 - 7 Rules for Crafting Developer-Friendly API Libraries, Beppe Catanese, Adyen

7 Rules for Crafting Developer-Friendly API Libraries
Beppe Catanese, Developer Advocate at Adyen

apidays Paris 2024 - The Future API Stack for Mass Innovation
December 3 - 5, 2024

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

Transcript

1. 7 Rules for Crafting Developer-Friendly API Libraries
2. 7 Golden Rules Adyen Libraries Intro Agenda
3. Developer Relations Me @beppecatanese gcatanese
4. Adyen Financial technology Large merchants and marketplaces 4 technical hubs
5. Meet your devs Abstraction Productivity API Libraries: what and why
6. Online payments In-person payments Financial Services Management API Webhooks Adyen Libraries github.com/adyen
7. OpenAPI pipeline
8. OpenAPI driven Idiomatic Release Notes Code snippets 7 Golden Rules Reference implementation Deprecation strategy Great documentation 📚 https://beppecatanese.hashnode.dev/api-libraries-7-golden-rules
9. From schema to code ✨ Automation ✨ ✨ Speed ✨ ✨ Consistency ✨ OpenAPI driven Source code templates Code duplication Drop and (re)generate Living downstream
10. OpenAPI driven lifecycle Design, code, ship, repeat
11. Naming conventions Error handling Data types Language features Idiomatic Multiple languages Invisible errors Dependencies & frameworks
12. 💎 Release notes ⚠ Breaking changes Release Notes Effort OpenAPI Diff tools
13. Multiple languages Compiles and runs Complete and readable Ready to go Code snippets Unit testing OpenAPI examples
14. github.com/adyen-examples Multiple languages Various use cases Webhooks Reference implementation Gitpod and Codespaces Upgrade path
15. Deprecation policy Annotations Deprecation markers OpenAPI driven Enriching with -x extensions
16. Comprehensive guide Examples, snippets Best practises Additional resources Great documentation GitHub or documentation
17. Best rules Automation with value Measuring Final thoughts
18. Thank you!