This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.

Difference between revisions of "API calls"

From Group-Office Groupware and CRM Documentation
Jump to: navigation, search
(→‎Logging in)
(→‎Logging in)
Line 1: Line 1:
 
==Logging in==
 
==Logging in==
−
You can login to Group-Office using http calls. Here's a PHP CURL example:
+
Here's some sample code on how to login to Group-Office with the CURL based HTTP client and get notes from the demo.
 
<pre>
 
<pre>
 +
 
<?php
 
<?php
  
−
$tmpdir = '/tmp';
+
//Adjust this path to suit your needs
−
$baseUrl = 'http://localhost/groupoffice/index.php';
+
require('/usr/share/groupoffice/GO.php');
−
$username = 'admin';
+
−
$password = 'admin';
+
  
−
$ch = curl_init();
+
//not required but can be used to get CLI input params
 +
$params = GO_Base_Util_Cli::parseArgs();
  
 +
$host = 'http://demo.group-office.eu/';
  
−
$cookieFile = $tmpdir . '/cookie.txt';
+
//Login
 +
$httpClient = new GO_Base_Util_HttpClient();
 +
$success = $httpClient->groupofficeLogin($host, 'demo','demo');
  
 +
if(!$success)
 +
        throw new Exception("Could not login to Group-Office");
  
−
curl_setopt($ch, CURLOPT_COOKIEJAR, $cookieFile);
+
//Get notes
−
curl_setopt($ch, CURLOPT_COOKIEFILE, $cookieFile);
+
$response = $httpClient->request($host,array(
 +
                'r'=>'notes/note/store',
 +
      'start'=>0,
 +
      'limit'=>10
  
−
//for self-signed certificates
+
));
−
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+
−
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+
−
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
+
−
curl_setopt($ch, CURLOPT_ENCODING, "UTF-8");
+
  
−
 
+
$result = json_decode($response);
−
$postfields = array(
+
//print names
−
'username' => $username,
+
foreach($result->results as $record){
−
'password' => $password
+
  echo $record->name."<br>\n";
−
);
+
−
 
+
−
 
+
−
curl_setopt($ch, CURLOPT_URL,$baseUrl . '?r=auth/login');
+
−
curl_setopt($ch, CURLOPT_POST, true);
+
−
curl_setopt($ch, CURLOPT_POSTFIELDS, $postfields);
+
−
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Requested-With: XMLHttpRequest"));
+
−
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+
−
 
+
−
$response = curl_exec($ch);
+
−
+
−
$error = curl_error($ch);
+
−
if(!empty($error))
+
−
die("curl error: ".$error);
+
−
 
+
−
$response = json_decode($response, true);
+
−
 
+
−
var_dump($response);
+
−
 
+
−
</pre>
+
−
 
+
−
Running this script should return something like:
+
−
 
+
−
<pre>
+
−
array(4) {
+
−
  ["success"]=>
+
−
  bool(true)
+
−
  ["user_id"]=>
+
−
  string(1) "1"
+
−
  ["security_token"]=>
+
−
  string(20) "nbhr9pmksfvg4czwjldq"
+
−
  ["sid"]=>
+
−
  string(26) "eiijnl8iupkk345qpnhaukvml6"
+
 
}
 
}
 
</pre>
 
</pre>
−
 
−
The security token must be send as parameter to each request. Learn more about controller actions on the [[Controllers]] page.
 

Revision as of 14:35, 27 August 2013

Logging in

Here's some sample code on how to login to Group-Office with the CURL based HTTP client and get notes from the demo. 


<?php

//Adjust this path to suit your needs
require('/usr/share/groupoffice/GO.php');

//not required but can be used to get CLI input params
$params = GO_Base_Util_Cli::parseArgs();

$host = 'http://demo.group-office.eu/';

//Login
$httpClient = new GO_Base_Util_HttpClient();
$success = $httpClient->groupofficeLogin($host, 'demo','demo');

if(!$success)
        throw new Exception("Could not login to Group-Office");

//Get notes
$response = $httpClient->request($host,array(
                'r'=>'notes/note/store',
      'start'=>0,
      'limit'=>10

));

$result = json_decode($response);
//print names
foreach($result->results as $record){
   echo $record->name."<br>\n";
}
Retrieved from "http://www.group-office.com/w/index.php?title=API_calls&oldid=3556"