Full API documentation: https://positionly.com/api
Table of Contents
Piotr Athlan Pelczar - me@athlan.pl
Add dependency in composer.json
:
"require": {
"getfokus/positionly": "*"
},
- Set credentials (clientId, clientSecret, username and password) for OAuth2 authentication and create OAuth2\Client object.
- Obtain the OAuth2 Access Token (password method)
- Pass client object into PositionlyApi instance.
- Call the api:
$response = $api->get('/accounts'); // for https://api.positionly.com/v1/accounts.json
// the $response contains the array with result
To make GET
request just use:
$response = $api->get('/accounts');
$response = $api->get('/accounts/<account id>/websites');
if($response->isSuccess()) {
echo 'Success:';
$result = $response->getResult();
print_r($result);
}
else {
echo 'Failure.';
}
To make DELETE
request just use:
$response = $api->delete('/accounts/<account id>/websites/<website id>');
if($response->isSuccess()) {
echo 'Success:';
}
else {
echo 'Failure.';
}
To make POST
request just use:
$params = array(
'scheme' => 'http',
'name' => 'example.com',
'title' => 'Example website',
'website_engines_attributes' => array(
array(
"engine_id" => 43,
)
)
);
$response = $api->post('/accounts/<account id>/websites', $params);
if($response->isSuccess()) {
echo 'Success:';
$result = $response->getResult();
print_r($result);
}
else {
echo 'There are errors in form:';
$result = $response->getResult();
print_r($result['errors']);
}
<?php
require_once __DIR__ . '/../vendor/autoload.php';
use PositionlyApi\PositionlyApi;
$clientId = '';
$clientSecret = '';
$username = '';
$password = '';
$client = new OAuth2\Client($clientId, $clientSecret);
$authorizationParams = array(
'username' => $username,
'password' => $password,
);
$result = $client->getAccessToken(PositionlyApi::getTokenEndpoint(), 'password', $authorizationParams);
$accessToken = json_decode($result['result'], true);
$client->setAccessToken($accessToken['access_token']);
$api = new PositionlyApi($client);
// get accounts
$response = $api->get('/accounts');
print_r($response);
?>