What is? API file ？
API The document is a deliverable technical content , It's about how to use and integrate effectively API Explanation . This is also a simple reference manual , Written to use API All the information you need , And related functions 、 Return type 、 Parameters and other details , And provides tutorial and example support .
API Documents are usually done by regular content creation and maintenance tools and text editors . for example Swagger、eolinker Norms and so on API Description formats have automated document processing , This makes it easier for teams to build and maintain API.
Third party developers are API Primary users of , Is busy solving complex programming problems .API It's a means for technology users to achieve their goals , They want to integrate as soon as possible to advance their software development , This means they should get to know your API The value and use of . Developers are discovering 、 Learn to use and eventually work with API The experience gained during integration is called developer experience .API Documentation is the key to getting great developer experience .
Why use documentation API？
stay API At all stages of the life cycle , Documentation is probably the fastest growing area . This is especially true for the tool ecosystem around documents . It's interesting to note this trend , Because traditionally , Documentation is something that developers rarely pay attention to when writing code . actually , It's much easier to implement code than to write good documentation .
Improve user usage
Have good API An important reason for documentation is , It improves developer use of API Experience , This is related to API The adoption of is directly related to . If API The document is correct , Then more people will easily find value in the services they provide , So that we can better develop and adopt .
Save support time and cost
Good documentation can also reduce the number of new users （ Whether it's internal developers or external partners ） Training time . Poor documentation or no documentation means more users rely on team training to understand how to use API.
contrary , When you use API Try it out before API, And equipped with detailed api file , It will save the team a lot of time to reply to email and phone calls .
Easy to maintain
Documentation can bring good product maintenance . It can help internal teams understand resources 、 Method and its associated request and response details , So that it can be maintained and updated more quickly .
Use API when , Documentation is the key to a good experience . It not only improves user satisfaction , It can also be improved API The usage rate of . In providing excellent API Under the condition of document ,api The management platform also supports testing 、 Monitoring and other functions , Let users use API Get a great experience with .
original text ：https://dzone.com/articles/wh...