When I find APIs that show a few examples but miss detailed specs I always miss the latter. I agree examples are great for a variety of purposes, but they're n

When I find APIs that show a few examples but miss detailed specs I always miss the latter. I agree examples are great for a variety of purposes, but they're no substitute for detailing the API endpoints, authorization mechanism, data types, etc.