The small API cleanup that saved us later

One thing I keep relearning in backend work is that messy API names cost more later than the original bug. On one project we had three endpoints returning the same customer object with slightly different fields. It worked until the mobile app started caching one shape and web expected another. The fix was not fancy: one serializer, one place for defaults, and a small contract test that hit the re…