Download the PHP package stitch-digital/laravel-simpro-api without Composer

Laravel package for working with the Simpro API

Laravel Simpro is a robust package designed to seamlessly integrate your Laravel application with the Simpro API.

The full Simpro API documentation can be found here.

Table of Contents

• Installation
• Usage
  • Using a Single Simpro Connection
  • Using Multiple Simpro Connections
• Available Requests
• Useful Methods
  • Responses
  • Pagination
  • Rate Limiting
  • Caching
  • Retries
  • Query Parameters
• Changelog
• Contributing
• Security
• Credits
• License

Installation

Laravel Simpro API can be installed using composer:

Then publish the config file:

This will publish the configuration file to config/simpro-api.php where you can configure your settings.

This package is built using Saloon. Check out their documentation here.

Usage

Using a Single Simpro Connection

If you are using a single Simpro connection, you can add the following environment variables to your .env file:

To use the package, you can use the Simpro facade to make requests to the API:

If you prefer to use dependency injection over facades then you can do this too:

Using Multiple Simpro Connections

If you are using multiple Simpro connections, you can pass the base URL and API key to the constructor of the connector:

Available Requests

For a full list of available requests, use the following command:

Useful Methods

Responses

After sending a request to the Simpro API, a Response class is returned. In most of the examples, we show the json method that returns a JSON response body. Below are some of the key methods provided by Saloon's Response class:

Pagination

This package uses the Saloon Paged Paginator for all GET requests that return multiple results.

There are various ways to use the paginator, all well documented in the Saloon docs - here is an example:

Let's say we want to retrieve all customers from Simpro. We can use the 'GetCustomers' request:

However, Simpro will paginate responses by default to a page size of 30 results. We can see this if we return the headers for the same request:

This will return pagination data in the headers:

The easiest way to use the paginator is to collect all responses like this:

When using the paginator, you can override the Simpro default per page limit of 30 by chaining the setPerPageLimit method to the request:

The maximum per page limit is 250.

[!WARNING]
Take care when increasing the per page limit. If you are dealing with large datasets and performing complex operations, you may want to keep this at the default to avoid memory issues.

Rate Limiting

This package uses the Saloon Rate Limiter Plugin to rate limit requests to the Simpro API.

You can disable rate limited globally in the config file, as well as set the rate limit, threshold and driver:

You can also disable rate limiting on a per-request basis by chaining the useRateLimitPlugin(false) method to the request:

Caching

This package uses the Saloon Caching Plugin to cache GET requests to the Simpro API.

You can disable caching globally in the config file, as well as set the cache driver and expiry time:

Retries

You can control the global retry configuration in the config file:

Query Parameters

You can add query parameters to your requests by chaining the query method to the request:

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Contributions are welcome and will be fully credited! Contributions are accepted via Pull Requests on GitHub.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• John Trickett
• Anthony Elleray
• Sam Carré - The Creator of Saloon
• All Contributors

License

The MIT License (MIT). Please see License File for more information.