PHP Client for the Teamleader API
This application is still in development and could implement breaking changes. Please use at your own risk.
You can install the package with composer
composer require justijndepover/teamleader-api
To use the plugin in Laravel applications, please refer to the Laravel usage page
Connecting to Teamleader:
// note the state param: this can be a random string. It's used as an extra layer of protection. Teamleader will return this value when connecting.
$teamleader = new Teamleader(CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, STATE);
// open the teamleader login
header("Location: {$teamleader->redirectForAuthorizationUrl()}");
exit;
After connecting, Teamleader will send a request back to your redirect uri.
$teamleader = new Teamleader(CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, STATE);
if ($_GET['error']) {
// your application should handle this error
}
if ($_GET['state'] != $teamleader->getState()) {
// state value does not match, your application should handle this error
}
$teamleader->setAuthorizationCode($_GET['code']);
$teamleader->connect();
// store these values:
$accessToken = $teamleader->getAccessToken();
$refreshToken = $teamleader->getRefreshToken();
$expiresAt = $teamleader->getTokenExpiresAt();
Your application is now connected. To start fetching data:
$teamleader = new Teamleader(CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, STATE);
$teamleader->setAccessToken($accessToken);
$teamleader->setRefreshToken($refreshToken);
$teamleader->setTokenExpiresAt($expiresAt);
// fetch data:
$teamleader->crm->get();
// you should always store your tokens at the end of a call
$accessToken = $teamleader->getAccessToken();
$refreshToken = $teamleader->getRefreshToken();
$expiresAt = $teamleader->getTokenExpiresAt();
Note that your application should have the correct scopes enabled inside the integration
This application is in an early development stage. Therefore not all resources are available as props yet. (for example: $teamleader->users->me
)
In the meantime it's possible to fetch every resource available through the get
and post
methods:
$teamleader->get('users.me');
$teamleader->get('departments.list');
$teamleader->get('departments.info', ['id' => $id]);
$teamleader->post('contacts.add', [
// all the data
]);
After each request, the rate limiting headers are available.
// returns the maximum rate limit your application can hit in 1 minute
$teamleader->getRateLimitLimit();
// returns the current limit remaining
$teamleader->getRateLimitRemaining();
// returns the datetime (UTC) when your application can make calls again, after hitting the rate limit.
$teamleader->getRateLimitReset();
How you handle rate limiting is up to you. But the application provides a helper method to ensure you never hit the limit:
$teamleader->get('contacts.info', ['id' => $id]);
// executing this function will sleep until the X-RateLimitReset header has passed, but only if the rate limit is hit.
$teamleader->ensureRateLimitingIsNotExceeded();
If you find any security related issues, please open an issue or contact me directly at justijndepover@gmail.com.
If you wish to make any changes or improvements to the package, feel free to make a pull request.
The MIT License (MIT). Please see License File for more information.