Blog Layout

Authenticating.com API Experience Review

Bill Doerrfeld | May 10, 2020
I was recently tasked to audit the Developer Experience of the Authenticating.com APIs, a suite of low code APIs for developers to add trust and safety to their applications.

My goal was to provide actionable insights to improve the DX and marketability of the service. The project culminated in a 14 page report and 1-1 consultation. 

Overall, though I found developer experience hangups with Authenticating.com, the core service has strong market potential.

Certain API design incongruities were found while testing. Certain API calls didn't match documentation in practice. Error handling was inconsistent. No sandbox existed, no developer account dashboard was live, and doc design looked like a basic template. I also found endpoint naming inconsistencies, and other style issues.

My recommendations included standardizing API design and style elements, and improving documentation to be more explicit for more use cases and circumstances. I recommended adding an OpenAPI specification as a source of truth, and a sandbox for API testing. 

As the API landscape grows, developer experience is becoming more of a top concern, especially for newcomers trying to get a foothold in the market. I really enjoyed this project and hope to do more developer experience reviews in the future!

More Info: Developer Experience Reviews
Can LLMs accelerate requirements engineering?
By Bill Doerrfeld March 6, 2025
New research shows LLMs outperform humans in software requirements engineering, reducing weeks of work to seconds while improving completeness by 10.2%.
Infoworld feature on ebpf and container networking
By Bill Doerrfeld March 3, 2025
Containers are designed to be isolated—that's great for security but tricky for networking. My feature with InfoWorld explores how eBPF is evolving container networking.
Agentic AI DirectorPlus New Relic
By Bill Doerrfeld February 28, 2025
I recently synced with Camden Swita, Head of AI and ML Innovation at New Relic, to see how software engineers are implementing agentic AI in practice.
Study reveals growing technical debt in AI age
By Bill Doerrfeld February 19, 2025
The 2nd annual code quality report from GitClear found 10x more duplicated code than two years ago and fewer signs of code reuse than ever before.
Kubernetes usability InfoWorld pilot cockpit Doerrfeld
By Bill Doerrfeld February 10, 2025
My feature on InfoWorld explores the state of Kubernetes usability, highlighting various advancements across workload types, support for edge and AI, and new features like observability and security.
Carving out time for large-scale engineering chores
By Bill Doerrfeld January 31, 2025
It's up to leadership to help prioritize large-scale engineering updates that keep software running smoothly. Kent Wills, Director of Engineering at Yelp, provides insight on the latest DirectorPlus.
5 potential use cases for Arazzo
By Bill Doerrfeld January 30, 2025
Italian for “tapestry,” Arazzo is aptly named since it can be used to weave together sequences of API calls to illustrate a specific business pattern.
How genAI can aid Kubernetes troubleshooting
By Bill Doerrfeld December 23, 2024
I caught up with CTO Itiel Shwartz about leveraging finely tuned models like Komodor’s KlaudiaAI agent for ultra-specific DevOps challenges, like Kubernetes error diagnosis and remediation challenges.
Framing AI in the right light
By Bill Doerrfeld December 20, 2024
Rolling out AI is all about framing it in a positive light, says GitLab's CTO, Sabrina Farmer. I interviewed her for the latest edition of DirectorPlus for LeadDev, which is out today.
What's on the top of CIOs' minds lately? Resilience.
By Bill Doerrfeld December 19, 2024
Surmounting risks are encouraging CIOs to future-proof and update their resilience strategies. My latest feature for CIO.com explores resilience head-on.
More Posts
Share by: