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.
More Info: Developer Experience Reviews
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!
How do you fail at platform engineering? Make it 100% UI-first. Don't market it. Survey no one. Measure success by who's onboarded. And just copy what others are doing.
This year's Platform Summit felt reinvigorated, with many new motivations and areas to discuss. Of course, AI agents and MCP stole the show.
For my latest DirectorPlus edition, I interviewed Thomas Johnson, co-founder and CTO of Multiplayer, about lessons learned releasing their MCP server.
Explore whether vector native databases outperform traditional DBs with vector add-ons for AI. Learn use cases, tradeoffs, and expert insights.
Join me in Stockholm for Platform Summit 2025 and the API Security UnConference, October 13–15. Exciting talks, networking, and more.
MCP shines for indeterministic workflows, novel integrations, and giving AI coding agents context on the fly. But for more predictable automation it may be overengineeering.
For my latest DirectorPlus column with LeadDev, I synced with JB Brown, VP of engineering at Smartsheet, to learn about their multi-agent AI development strategy.
Alternative clouds are having a moment. Nearly 75% of orgs are using two or more alt clouds beyond the hyperscalers, according to a HostingAdvice.com report.
The cloud is no longer borderless. Rising regional data laws and sovereign cloud mandates are forcing CIOs to act.
In a multi-agent coding workflow, an engineer leads a "team" of specialist AI agents to perform various SDLC tasks: scaffolding, coding, testing, log analysis, deployment, and more.
