blesta_sdk 0.1

A Python SDK for interacting with Blesta API

Blesta Python SDK

The Blesta Python SDK provides an easy-to-use API and CLI interface for interacting with Blesta's REST API.

🚀 Quick and Easy Setup

1. Create a Project Folder:

   mkdir my_project && cd my_project
   

2. Set Up a Python Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate  # On Windows, use venv\Scripts\activate
   

3. Install Blesta SDK:

   pip install blesta_cli
   

4. Configure API Credentials:

   Admins can generate API credentials in Blesta's staff area. Save these values in a .env file located in your project's root folder. The .env file should look like this:

   BLESTA_API_URL=https://your-blesta-domain.com/api
   BLESTA_API_USER=your_api_user
   BLESTA_API_KEY=your_api_key
   

That's it. Let's roll!

📖 Usage Examples

General Command Structure

blesta-cli --model <model_name> --method <method_name> [--action GET] [--params key=value key2=value2] [--last-request]

• --model: The API model to interact with (e.g., clients, services).
• --method: The method to call on the specified model (e.g., getList, get, getCustomFields).
• --action: The HTTP action to perform (default is GET).
• --params: Optional parameters to pass to the method (e.g., key=value pairs).
• --last-request: Repeats the last request made.

Clients Model (API Documentation)

• List all active clients:

  blesta-cli --model clients --method getList --params status=active --last-request
  

• Get details of a specific client:

  blesta-cli --model clients --method get --params client_id=1 --last-request
  

Services Model (API Documentation)

• List all active services:

  blesta-cli --model services --method getList --params status=active --last-request
  

• Count the active services for a client:

  blesta-cli --model services --method getListCount --params client_id=1 status=active
  

• List all services for a client:

  blesta-cli --model services --method getAllByClient --params client_id=1 status=active --last-request
  

🤝 Contribution

We welcome contributions! Whether it's a feature request, bug report, or pull request, we appreciate your input.

How to Contribute

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature/your-feature-name
   

3. Commit your changes:

   git commit -m "Add your feature description here"
   

4. Push to your branch:

   git push origin feature/your-feature-name
   

5. Open a pull request.

---

This project is licensed under the MIT License

Happy coding! 🎉