This blog article explains the differences between API documentation, API specifications, and API definitions. All three of these things are related, but serve different purposes when it comes to API design.