Active Collab 5 SDK

0

Connecting to Active Collab Cloud Accounts `php <?php require_once ‘/path/to/vendor/autoload.php’; // Provide name of your company, name of the app that you are developing, your

Version
Last updated
Active installations
Rating
Total ratings
This plugin is outdated and might not be supported anymore.

Description

Connecting to Active Collab Cloud Accounts

`php

<?php

require_once ‘/path/to/vendor/autoload.php’;

// Provide name of your company, name of the app that you are developing, your email address and password.
$authenticator = new ActiveCollabSDKAuthenticatorCloud(‘ACME Inc’, ‘My Awesome Application’, ‘you@acmeinc.com’, ‘hard to guess, easy to remember’);

// Show all Active Collab 5 and up account that this user has access to.
print_r($authenticator->getAccounts());

// Show user details (first name, last name and avatar URL).
print_r($authenticator->getUser());

// Issue a token for account #123456789.
$token = $authenticator->issueToken(123456789);

// Did we get it?
if ($token instanceof ActiveCollabSDKTokenInterface) {
print $token->getUrl() . “n”;
print $token->getToken() . “n”;
} else {
print “Invalid responsen”;
die();
}
<h3>Connecting to Self-Hosted Active Collab Accounts</h3>php
require_once ‘/path/to/vendor/autoload.php’;

// Provide name of your company, name of the app that you are developing, your email address and password. Last parameter is URL where your Active Collab is installed.
$authenticator = new ActiveCollabSDKAuthenticatorSelfHosted(‘ACME Inc’, ‘My Awesome Application’, ‘you@acmeinc.com’, ‘hard to guess, easy to remember’, ‘https://my.company.com/projects’);

// Issue a token.
$token = $authenticator->issueToken();

// Did we get what we asked for?
if ($token instanceof ActiveCollabSDKTokenInterface) {
print $token->getUrl() . “n”;
print $token->getToken() . “n”;
} else {
print “Invalid responsen”;
die();
}
`

SSL problems?

If curl complains that SSL peer verification has failed, you can turn it off like this:

`php

// Cloud
$authenticator = new ActiveCollabSDKAuthenticatorCloud(‘ACME Inc’, ‘My Awesome Application’, ‘you@acmeinc.com’, ‘hard to guess, easy to remember’, false);
$authenticator->setSslVerifyPeer(false);

// Self-hosted
$authenticator = new ActiveCollabSDKAuthenticatorSelfHosted(‘ACME Inc’, ‘My Awesome Application’, ‘you@acmeinc.com’, ‘hard to guess, easy to remember’, ‘https://my.company.com/projects’, false);
$authenticator->setSslVerifyPeer(false);

// Client
$client = new ActiveCollabSDKClient($token);
$client->setSslVerifyPeer(false);
`

Note: Option to turn off SSL peer verification has been added in Active Collab SDK 3.1.

Constructing a client instance

Once we have our token, we can construct a client and make API calls:

`php

$client = new ActiveCollabSDKClient($token);
`

Listing all tasks in project #65 is easy. Just call:

`php

$client->get(‘projects/65/tasks’);
`

To create a task, simply send a POST request:

`php

try {
$client->post(‘projects/65/tasks’, [
‘name’ => ‘This is a task name’,
‘assignee_id’ => 48
]);
} catch(AppException $e) {
print $e->getMessage() . ‘

‘;
// var_dump($e->getServerResponse()); (need more info?)
}
`

To update a task, PUT request will be needed:

`php

try {
$client->put(‘projects/65/tasks/123’, [
‘name’ => ‘Updated named’
]);
} catch(AppException $e) {
print $e->getMessage() . ‘

‘;
// var_dump($e->getServerResponse()); (need more info?)
}
`

post()`` and ``put()`` methods can take two arguments:
  1. command (required) – API command,
  2. variables – array of request variables (payload)

To remove a task, call:

`php

try {
$client->delete(‘projects/65/tasks/123’);
} catch(AppException $e) {
print $e->getMessage() . ‘

‘;
// var_dump($e->getServerResponse()); (need more info?)
}
`

delete()`` method only requires ``command`` argument to be provided.

For full list of available API command, please check Active Collab API documentation.