Skip to content

Latest commit

 

History

History
106 lines (70 loc) · 2.85 KB

README.md

File metadata and controls

106 lines (70 loc) · 2.85 KB
Raw

Cronofy

Cronofy - one API for all the calendars (Google, iCloud, Exchange, Office 365, Outlook.com)

Usage

In order to use the Cronofy API you will need to create a developer account.

From there you can create personal access tokens to access your own calendars, or you can create an OAuth application to obtain an OAuth client_id and client_secret to be able to use the full API.

Authorization

API documentation

Generate a link for a user to grant access to their calendars:

$redirect_uri = "http://yoursite.dev/oauth2/callback";

$cronofy = new Cronofy("clientId");
$params = array(
	'redirect_uri' => $redirect_uri,
	'scope' => array('read_account','list_calendars','read_events','create_event','delete_event')
);
$auth = $cronofy->getAuthorizationURL($params);

The redirect URI is a page on your website that will handle the OAuth 2.0 callback and receive a code parameter. You can then use that code to retrieve an OAuth token granting access to the user's Cronofy account:

$cronofy = new Cronofy("clientId", "ClientSecret");

$params = array(
	'redirect_uri' => $redirect_uri,
	'code' => $code
);

$token=$cronofy->request_token($params);

You should save the response's AccessToken and RefreshToken for later use.

Note that the exact same redirect URI must be passed to both methods for access to be granted.

List calendars

API documentation

Get a list of all the user's calendars:

$cronofy = new Cronofy("clientId", "ClientSecret", "AccessToken", "RefreshToken");
$calendar = $cronofy->list_calendars();

Create or update events

API documentation

To create/update an event in the user's calendar:

$cronofy = new Cronofy("clientId", "ClientSecret", "AccessToken", "RefreshToken");

$params = array(
	'calendar_id' => 'calendarID',
	'event_id' => 'event_test_12345679',
	'summary' => 'test event 2',
	'description' => 'some event data here',
	'start' => '2015-12-07T09:00:00Z',
	'end' => '2015-12-08T10:00:00Z'
	
);
$new_event = $cronofy->upsert_event($params);

Delete events

API documentation

To delete an event from user's calendar:

$cronofy = new Cronofy("clientId", "ClientSecret", "AccessToken", "RefreshToken");

$params = array(
	'calendar_id' => 'calendarID',
	'event_id' => 'EventID'
);

$delete = $cronofy->delete_event($params);

Links