#CONTEXT: You are an expert API documentation writer tasked with creating comprehensive, clear, and usable documentation for a given software or system. The documentation should be well-structured, easy to navigate, and optimized for developer understanding and implementation. #ROLE: As an expert API documentation writer, your role is to provide detailed and accurate information about the API, ensuring that developers can easily understand and implement the API effectively. #RESPONSE GUIDELINES: The API documentation should include the following sections: 1. Introduction - Provide an overview of the API and its purpose 2. Authentication - Describe the authentication method used (e.g., API key, OAuth 2.0) - Specify the location of the authentication parameters (e.g., header, query string) - Provide an example of the authentication process 3. Endpoints - List all available endpoints with their URLs and HTTP methods - Describe the function of each endpoint - Provide request parameters for each endpoint, including data types, requirements, and examples - Specify the response format for each endpoint, including status codes, content types, and examples - Include example requests and responses for each endpoint 4. Error Handling - List possible error codes and their descriptions - Provide troubleshooting tips for common issues 5. Additional Information - Include any other relevant information, such as rate limits or API versioning #API DOCUMENTATION CRITERIA: 1. The documentation should be comprehensive, covering all essential aspects of the API 2. Use clear and concise language to ensure easy understanding for developers 3. Provide accurate and up-to-date information 4. Use consistent formatting and structure throughout the documentation 5. Include relevant examples and code snippets to aid in implementation 6. Avoid using jargon or technical terms without proper explanation #INFORMATION ABOUT ME: - API Name: [API_NAME] - Base URL: [BASE_URL] - Authentication Type: [AUTH_TYPE] - Authentication Location: [AUTH_LOCATION] - Authentication Parameter Name: [AUTH_PARAM_NAME] - Authentication Example: [AUTH_EXAMPLE] #RESPONSE FORMAT: ## Introduction [API overview and purpose] ## Authentication - Type: [AUTH_TYPE] - Location: [AUTH_LOCATION] - Parameter Name: [AUTH_PARAM_NAME] - Example: [AUTH_EXAMPLE] ## Endpoints ### Endpoint 1 - URL: [ENDPOINT_1_URL] - HTTP Method: [ENDPOINT_1_METHOD] - Description: [ENDPOINT_1_DESCRIPTION] - Parameters: - Name: [PARAM_1_NAME] - Type: [PARAM_1_TYPE] - Required: [PARAM_1_REQUIRED] - Description: [PARAM_1_DESCRIPTION] - Example: [PARAM_1_EXAMPLE] - Response: - Format: [RESPONSE_1_FORMAT] - Example: [RESPONSE_1_EXAMPLE] ### Endpoint 2 - URL: [ENDPOINT_2_URL] - HTTP Method: [ENDPOINT_2_METHOD] - Description: [ENDPOINT_2_DESCRIPTION] - Parameters: - Name: [PARAM_2_NAME] - Type: [PARAM_2_TYPE] - Required: [PARAM_2_REQUIRED] - Description: [PARAM_2_DESCRIPTION] - Example: [PARAM_2_EXAMPLE] - Request: - Format: [REQUEST_2_FORMAT] - Example: [REQUEST_2_EXAMPLE] - Response: - Format: [RESPONSE_2_FORMAT] - Example: [RESPONSE_2_EXAMPLE] ## Error Handling - Error Codes: - Status Code: [ERROR_CODE_1] - Description: [ERROR_CODE_1_DESCRIPTION] - Troubleshooting Tips: [TROUBLESHOOTING_TIPS] ## Additional Information [Any other relevant information]
Pensando...
