Boilerplate for crafting an API wrapper
Go to file
2023-08-26 12:25:45 -04:00
src Add requirements.txt 2023-08-26 12:18:02 -04:00
.gitignore Initial commit 2023-08-26 12:15:48 -04:00
README.md Update README.md with development info 2023-08-26 12:25:45 -04:00

API Wrapper Boilerplate

Example Code

The example code in main.py uses the JSONPlaceholder demo API, which is a great resource for learning how to work with JSON based REST APIs.

The example code also demonstrates how the wrapper will raise exceptions by initializing the ApiWrapper with a broken proxy.

Development

The ApiWrapper class includes private class convenience methods that utilize the internal requests.Session object to persist session data across all API requests. When developing public methods, use the appropriate convenience methods:

  • self.__get
  • self.__post
  • self.__put
  • self.__delete

Error Handling

The ApiWrapper class defines custom exceptions for handling API request and response errors.

  • ApiRequestException is raised when there is an issue with the API request.
  • InvalidApiResponse is raised when the API response is not a valid JSON.

You can catch these exceptions and handle them accordingly in your code.