3 Areas to Cover while doing API Documentation
- Landing page which provides details such as high level information of APIs, links to APIs pages, release information, changelog details
- A summary page providing an overview on APIs in general, list of API names and one liner for each of the APIs
- One page each for each of the APIs where following details could be included:
- API Description providing details on some of the following:
- Functional details including information on what API accomplishes
- API syntax including method signature and request, response parameters
- Request and response parameters such as parameters’ description, data type, mandatory or optional information
- Exception details including error codes, what do they mean and how to handle them.
- One or more code examples which could be used by developers when integrating with APIs
- Related APIs which are used along with this API or which provide greater details in relation with functioning of the API
- References, if any, to get further details about APIs
- API Description providing details on some of the following:
- Account Receivables Use Cases for Machine Learning - June 26, 2022
- Cash Forecasting Models & Treasury Management - June 26, 2022
- Accounts Payable Machine Learning Use Cases - June 26, 2022
Leave a Reply