PHPebbleTimeline is a library for making use the Timeline API through PHP.

PHP 5.3 or Higher installed with cURL

Ensure your application is setup to use Pebble Timeline

Copy the TimelineAPI Folder to your project's directory.

Require the TimelineAPI in your project:

require_once 'PATH/TO/API/Timeline.php';

A Pin object represents the Timeline Pin which will be pushed to the watch.

To create a pin object be sure to use the Pin class

use TimelineAPI\Pin;

A Pin Object accepts the following parameters

Here is an example pin using a very generic PinLayout:

// Create the layout object for our pin
$genericLayout = new PinLayout(PinLayoutType::GENERIC_PIN, 'MY PIN TITLE', null, null, null, PinIcon::NOTIFICATION_FLAG);

//Create an instance of our pin
$pin = new Pin('MY-SAMPLE-PIN', (new DateTime('now')) -> now(new DateInterval('PT30M')), $genericLayout);

getID returns the string representation of your pin's ID.

//Returns 'MY-SAMPLE-PIN' for the above sample pin
$pin -> getID();

addReminder adds a PinReminder to the Pin object. A maximum of 3 PinReminder objects can be added.

Returns true if the reminder was added; otherwise false

//Create the layout of the reminder
$reminderlayout = new PinLayout(PinLayoutType::GENERIC_REMINDER, 'Sample reminder!', null, null, null, PinIcon::NOTIFICATION_FLAG);

//Create the reminder objects
$reminderOne = new PinReminder($reminderlayout, (new DateTime('now')) -> now(new DateInterval('PT10M'))); // 20 mins before the sample event
$reminderTwo = new PinReminder($reminderlayout, (new DateTime('now')) -> now(new DateInterval('PT20M'))); // 10 mins before the sample event
...
$reminderFour = new PinReminder($reminderlayout, (new DateTime('now')) -> now(new DateInterval('PT28M'))); // 2 mins before the sample event

//Add the reminder objects
$pin -> addReminder($reminderOne); //returns true and is added
$pin -> addReminder($reminderTwo); //returns true and is added
...
$pin -> addReminder($reminderFour); //returns false and is not added

addAction adds a PinAction to the Pin object. This action will be attached to the pin on the watch

//Create the PinAction objects
$actionOne = new PinAction('RSVP Yes', 1, PinActionType::OPEN_WATCH_APP); // Pin action to reply yes
$actionOne = new PinAction('RSVP No', 2, PinActionType::OPEN_WATCH_APP); // Pin action to reply no

//Add the reminder objects
$pin -> addAction($actionOne);
$pin -> addAction($actionOne);

getData returns an associative array of the pin's data

//Returns an array object representing all of the data added to our sample pin
$pin -> getData();

A PinLayout object represents the Layout Object which determine the styles of any views regarding your Pin on the Timeline.

To create a layout object be sure to use the PinLayout class

use TimelineAPI\PinLayout;

A PinLayout Object accepts the following parameters. Note that some optional parameters are required by certain PinLayoutTypes. More information available here: Layout Type

Here is an example pin using a very generic PinLayout:

// Create the layout object for our pin
$genericLayout = new PinLayout(PinLayoutType::GENERIC_PIN, 'MY PIN TITLE', null, null, null, PinIcon::NOTIFICATION_FLAG);

getData returns an associative array of the PinLayout's data

//Returns an array object representing all of the data added to our sample pin
$genericLayout -> getData();

A PinNotification object represents the Notification Object which will notify the user when a Pin changes status (created, updated).

To create a layout object be sure to use the PinNotification class

use TimelineAPI\PinNotification;

A PinNotification Object accepts the following parameters.

Here is an example notification.

$notificationLayout = new PinLayout(PinLayoutType::GENERIC_PIN, 'Pin updated', null, null, null, PinIcon::NOTIFICATION_FLAG);
$notification = new PinNotification($notificationLayout, new DateTime('now'));

getData returns an associative array of the PinNotification's data

$notification -> getData();

A PinReminder object represents the Reminder Object which will send a reminder to the user at a specific time.

To create a reminder object be sure to use the PinReminder class

use TimelineAPI\PinReminder;

A PinReminder Object accepts the following parameters.

Here is an example reminder.

$reminderlayout = new PinLayout(PinLayoutType::GENERIC_REMINDER, 'Sample reminder!', null, null, null, PinIcon::NOTIFICATION_FLAG);
$reminder = new PinReminder($reminderlayout, new DateTime('now')); //send the reminder right away

getData returns an associative array of the PinReminder's data

$reminder -> getData();

A PinAction object represents the Action Object which determine any actions your Pin may perform while on the Timeline.

To create an action object be sure to use the PinAction class

use TimelineAPI\PinAction;

A PinAction Object accepts the following parameters.

Here is an example of a RSVP PinAction:

$action = new PinAction('RSVP Yes', 1, PinActionType::OPEN_WATCH_APP); // Pin action to reply yes

getData returns an associative array of the PinAction's data

//Returns an array object representing all of the data added to our action
$action -> getData();

A PinLayoutType constant represents the Layout Types that are available. See available layouts for a list of all layout types supported. (If a layout is missing please let me know via the issue tracker!)

To retrieve layout types be sure to use the PinLayoutType class

use TimelineAPI\PinLayoutType;

The following code will get the layout type for a sports pin.

$layoutType = PinLayoutType::SPORTS_PIN;

A PinIcon constant represents the Pin Icons available. See available icons for a list of all icons supported. (If an icon is missing please let me know via the issue tracker!)

To retrieve pin icons be sure to use the PinIcon class

use TimelineAPI\PinIcon;

The following code will get the URI for a Notification flag.

$icon = PinIcon::NOTIFICATION_FLAG;

A PebbleColour constant represents the Pebble Colours that are available. See available Colours for a list of all colours supported. (If a colour is missing please let me know via the issue tracker!)

To retrieve colours be sure to use the PebbleColour class

use TimelineAPI\PebbleColour;

The following code will get the colour code for red.

$colour = PebbleColour::RED;

A PinActionType constant represents the Pin Actions that are available. See available action types for a list of all actions supported. (If an action is missing please let me know via the issue tracker!)

To retrieve actions be sure to use the PinActionType class

use TimelineAPI\PinActionType;

The following code will get the open action type.

$actionType = PinActionType::OPEN_WATCH_APP;

All timeline functions are static methods and can be accessed via the Timeline class. Be sure to use this class.

use TimelineAPI\Timeline;

Timeline::pushPin pushes a pin to the user's timeline. It requires a valid usertoken to target an individual user.

See responses for what responses will be returned. More information available at creating pins

Note that updating a pin uses this method as well. To update a pin push the id of the original pin.

$userToken = <Some valid userToken string>;
$pin = <some valid pin object>;
Timeline::pushPin($userToken, $pin);

Timeline::pushSharedPin pushes a pin to the the users' timelines. It requires a valid API key to send to multiple users. The parameter topics is an Array of type String containing all of the topics the pin should be pushed to. pin is the Pin to send to the users subscribed to those topics.

See responses for what responses will be returned. More information available at creating shared pins

$apiKey = <Your API key>;
$topics = ['Topic-1', 'Topic-2'];
$pin = <some valid pin object>;
Timeline::pushPin($apiKey, $topics, $pin);

Timeline::deletePin removes a pin to the the user's timeline. It requires a valid usertoken representing the watch that the pin should be removed from and the id of the pin to remove.

See responses for what responses will be returned. More information available at deleting pins

$userToken = <Some valid userToken string>;
$id = 'SAMPLE-PIN';
Timeline::deletePin($userToken, $id);

Timeline::deletePin removes a shared pin from all users' timelines. It requires a valid It requires a valid API key along with the id of the pin to be removed.

See responses for what responses will be returned. More information available at deleting shared pins

$apiKey = <Some valid userToken string>;
$id = 'SAMPLE-SHARED-PIN';
Timeline::deleteSharedPin($apiKey, $id);

Timeline::listSubscriptions lists all of a user's timeline subscriptions.

See responses for what responses will be returned. More information available at listing topics

$userToken = <Some valid userToken string>;
Timeline::listSubscriptions($userToken);

All Timeline functions return an associated array in the following form.

[status' => ['code' => RESPONSE_CODE, 'message' => RESULT_MESSAGE], 'result' => RAW_PEBBLE_RESULT]

status represents the overall status of the method called.

code is a valid response code

message is a valid response message

result is the raw JSON decoded object from the timeline