StuRents API Helper

Master branch is for v1.4 which is not available yet; please check releases for previous versions. For outbound data check 1.3., for inbound use 1.2.

Install using composer:

php composer.phar require sturents/api

Wait, what's Composer?

Composer is the de-facto package manager for PHP projects. If you haven't used it before it is very simple to set up.

1. Visit the Composer download page and follow instructions to download composer into your project root.
2. You should now have a file called composer.phar in your project root. You can run various commands using this file.
3. Start by running php composer.phar init to create your composer.json file. This file stores all your project configuration and dependencies.
4. Now either run the command at the top of the readme to install the StuRents API, or add "sturents/api": "*" to the "require" object inside your composer.json file.

To use Composer dependencies inside a PHP file is simple - just the following to the top of your file:

require_once __DIR__.'/vendor/autoload.php';

Now you can create or use any object without having to worry about requiring its files - Composer and PHP's autoloader will handle that for you.

Send a property to StuRents

$property = new \SturentsLib\Api\Models\Property;
// Use setters to create sub-objects and set properties as
// described in the documentation:
// https://sturents.com/software/developer/house-create

$sturents_upload = new \SturentsLib\Api\UploadToSturents(LANDLORD_ID, API_KEY);
try {
    $create_response = $sturents_upload->createOrUpdateProperty($property);
}
catch (\Exception $e){
   echo "A problem happened: ".$e->getMessage();
}

var_dump($create_response->success); // true if request succeeded

echo $create_response->sturents_id; // outputs an integer

var_dump($create_response->messages); // outputs an array of warnings/errors

Fetch data from StuRents

$sturents_fetch = new \Sturents\Api\FetchFromSturents(LANDLORD_ID, PUBLIC_KEY);
try {
    $properties = $sturents_fetch->fetchProperties();
}
catch (\Exception $e){
   echo "A problem happened: ".$e->getMessage();
}

echo count($properties) // echo, e.g. 1
echo $properties[0]->getAddress()->getRoad() // echo e.g. Test Street;