README

HaloAPI

HaloApi is a PHP Wrapper for the HaloITSM API. This class supports all endpoints and methods available in the API.

About The Project

HaloITSM is a powerful ITIL aligned IT Service Management tool. The REST API provides access to various information in the system. This wrapper was created to make calling the HaloITSM API easier and faster.

(back to top)

Getting Started

Prerequisites

The PHP curl extension is required.

php curl

Usage

Install with Composer

composer require derricksmith/haloapi:dev-main

------ OR ------

Include the class in your project.

require HaloApi.class.php

Then instantiate the class with the following parameters. See the HaloITSM API documentation for more information.

client_id client_secret grant_type scope host verifypeer

$halo = new HaloApi(array(
	'client_id' => '<your client id>', 
	'client_secret' => '<your client secret>', 
	'grant_type' => '<your grant type>',
	'scope' => '<your scope>',
	'host' => '<your Halo ITSM base URL>', 
	'verifypeer' => true
));

Then call an endpoint method in the class.

$request = array(
	'pageinate' => true,
	'page_size' => 50,
	'page_no' => 1,
	'columns_id' => 1,
	'includecolumns' => false,
	'ticketlinktype' => null,
	'searchactions' => null,
	'order' => 'id',
);
$tickets = $halo->getTickets($request);

(back to top)

Roadmap

Testing all api endpoints
Better error handling

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!