/**
* Gets Message based upon some filters
* @param mixed $start The date to start querying from.
* @param mixed $end The last possible time in the query.
* @param integer $index The number of results to skip from the result set. The default is 0.
* @param integer $limit The maximum number of results to return. This has a hard limit of 1000 messages.
* @param boolean $pending A true or false value used to indicate if only scheduled messages should be returned in the result set. By default only sent message are returned
* @param string $direction Used to filter the result by the direction of the message. Possible values are "in" (to return only inbound messages) and "out" (to return only outbound messages).
* @return ApiList|HttpResponse|null
* @throws ErrorException
*/
public function getMessages($start = null, $end = null, $index = null, $limit = null, $pending = null, $direction = null)
{
$resource = "/messages/";
if (!is_null($start)) {
if (!is_int($start) || !is_string($start)) {
throw new ErrorException("Parameter 'start' must be an integer Unix timestamp or a string time in this format (YYYY-MM-DD HH:MM:SS)");
}
if (is_string($start)) {
if (!CommonUtil::is_datetime($time)) {
throw new ErrorException("Parameter 'start' must be a string time in this format (YYYY-MM-DD HH:MM:SS)");
}
}
if (is_int($start) && $start < 0) {
throw new ErrorException("Parameter 'start' must be a positive integer");
}
}
if (!is_null($end)) {
if (!is_int($end) || !is_string($end)) {
throw new ErrorException("Parameter 'end' must be an integer Unix timestamp or a string time in this format (YYYY-MM-DD HH:MM:SS)");
}
if (is_string($end)) {
if (!CommonUtil::is_datetime($time)) {
throw new ErrorException("Parameter 'end' must be a string time in this format (YYYY-MM-DD HH:MM:SS)");
}
}
if (is_int($end) && $end < 0) {
throw new ErrorException("Parameter 'end' must be a positive integer");
}
}
if (!is_null($index) && !is_int($index)) {
throw new ErrorException("Parameter 'index' must be an integer");
}
if (!is_null($limit) && !is_int($limit)) {
throw new ErrorException("Parameter 'limit' must be an integer");
}
if (!is_null($pending) && (!CommonUtil::is_boolean($pending) || !is_bool($pending))) {
throw new ErrorException("Parameter 'pending' must be a boolean (1, 0, true, false)");
}
if (!is_null($direction)) {
if (!is_string($direction)) {
throw new ErrorException("Parameter 'direction' must be string");
} elseif ($direction !== MessageDirection::IN || $direction !== MessageDirection::OUT) {
throw new ErrorException("Parameter 'direction' must be string. Possible values are in or out");
}
}
try {
$params = array();
if (!is_null($start)) {
$params["start"] = is_string($start) ? $start : gmdate('Y-m-d H:i:s', $start);
}
if (!is_null($end)) {
$params["end"] = is_string($end) ? $end : gmdate('Y-m-d H:i:s', $end);
}
if (!is_null($index)) {
$params["index"] = $index > 0 ? $index : 0;
}
if (!is_null($limit)) {
$params["limit"] = $limit > 0 && $limit <= 1000 ? $limit : 1000;
}
if (!is_null($pending)) {
if ($pending === "true" || $pending || $pending === "1") {
$params["pending"] = "true";
}
if ($pending === "false" || $pending === false || $pending === "0") {
$params["pending"] = "false";
}
}
if (!is_null($direction)) {
$params["direction"] = $direction;
}
$response = $this->httpClient->get($resource, $params);
if ($response instanceof HttpResponse) {
if ($response->getStatus() === HttpStatusCode::HTTP_OK) {
$json = JsonHelper::getJson($response->getBody());
if (isset($json)) {
return new ApiList($json);
}
} else {
return $response;
}
}
} catch (Exception $ex) {
echo $ex->getTraceAsString();
}
return null;
}
/**
* Creates a new Contact Group
* @param mixed $group The contact group data. It can be an associative array or an instance of ContactGroup
* @return HttpResponse|null|ContactGroup
* @throws ErrorException
*/
public function addContactGroup($group)
{
$resource = "/contacts/groups/";
if (is_null($group)) {
throw new ErrorException("Parameter 'group' cannot be null");
}
if (!is_string($group) || !$group instanceof ContactGroup || !is_array($group)) {
throw new ErrorException("Parameter 'group' must be of type ContactGroup or an array or a string");
}
try {
$params = array();
if (is_string($group)) {
$params["Name"] = $group;
} else {
$params = is_array($group) ? $group : json_decode(JsonHelper::toJson($group), true);
}
$response = $this->httpClient->post($resource, $params);
if ($response instanceof HttpResponse) {
if ($response->getStatus() === HttpStatusCode::HTTP_CREATED) {
$json = JsonHelper::getJson($response->getBody());
if (isset($json)) {
return new ContactGroup($json);
}
} else {
return $response;
}
}
} catch (\Exception $ex) {
echo $ex->getTraceAsString();
}
return null;
}
/**
* Replies to a Support Ticket
* @param integer $ticketId
* @param mixed $request
* @return HttpResponse|null|Ticket
* @throws \ErrorException
*/
public function updateSupportTicket($ticketId, $request)
{
$resource = "/tickets/";
if (is_null($ticketId)) {
throw new \ErrorException("Parameter 'ticketId' cannot be null");
} elseif (!is_int($ticketId)) {
throw new \ErrorException("Parameter 'ticketId' must be an integer");
}
if (is_null($request)) {
throw new \ErrorException("Parameter 'request' cannot be null");
} elseif (!$request instanceof TicketResponse || !is_array($request)) {
throw new \ErrorException("Parameter 'request' must be of type TicketResponse or an array");
}
try {
$params = array();
$params = is_array($request) ? $request : json_decode(JsonHelper::toJson($request), true);
$response = $this->httpClient->put($resource, $params);
if ($response instanceof HttpResponse) {
if ($response->getStatus() === HttpStatusCode::HTTP_OK) {
$json = JsonHelper::getJson($response->getBody());
if (isset($json)) {
return new Ticket($json);
}
} else {
return $response;
}
}
} catch (\Exception $ex) {
echo $ex->getTraceAsString();
}
return null;
}
/**
* Updates the details of an existing content media.
* @param UUID $mediaId The content media
* @param MediaInfo $mediaInfo The content media details
* @return HttpResponse|ContentMedia|null
* @throws ErrorException
*/
public function updateContentMedia($mediaId, $mediaInfo = null)
{
$resource = "/media/";
if (is_null($mediaId)) {
throw new ErrorException("Parameter 'mediaId' cannot be null");
} elseif (!CommonUtil::is_uuid($mediaId)) {
throw new ErrorException("Parameter 'mediaId' must be a valid UUID");
}
if (!is_null($mediaInfo) && !$mediaInfo instanceof MediaInfo) {
throw new ErrorException("Parameter 'mediaInfo' cannot be null and must be an instance of MediaInfo.");
}
try {
$resource .= $mediaId;
// Set the mediainfo data
$params["ContentName"] = $mediaInfo->contentName;
$params["LibraryId"] = $mediaInfo->libraryId;
$params["DestinationFolder"] = $mediaInfo->destinationFolder;
$params["Preference"] = $mediaInfo->preference;
$params["Width"] = $mediaInfo->width;
$params["Height"] = $mediaInfo->height;
$params["DrmProtect"] = $mediaInfo->drmProtect;
$params["Streamable"] = $mediaInfo->streamable;
$params["DisplayText"] = $mediaInfo->displayText;
$params["ContentText"] = $mediaInfo->contentText;
$params["Tags"] = "";
// set the medainfo tags
if (!is_null($mediaInfo->tags) && is_array($mediaInfo->tags) && count($mediaInfo->tags) > 0) {
$params["Tags"] = JsonHelper::toJson($mediaInfo->tags);
}
$response = $this->httpClient->put($resource, $params);
if ($response instanceof HttpResponse) {
if ($response->getStatus() === HttpStatusCode::HTTP_OK) {
$json = JsonHelper::getJson($response->getBody());
if (isset($json)) {
return new ContentMedia($json);
}
} else {
return $response;
}
}
} catch (Exception $ex) {
$ex->getTraceAsString();
}
return null;
}
/**
* Get a voucher topup
* @param string $voucherNumber
* @return HttpResponse|Topup|null
* @throws ErrorException
*/
public function getVoucher($voucherNumber)
{
$resource = "/topup/voucher/";
if (is_null($voucherNumber)) {
throw new ErrorException("Parameter 'voucherNumber' cannot be null");
} elseif (!is_string($voucherNumber)) {
throw new ErrorException("Parameter 'voucherNumber' must be a string");
}
try {
$resource .= $voucherNumber;
$response = $this->httpClient->get($resource);
if ($response instanceof HttpResponse) {
if ($response->getStatus() === HttpStatusCode::HTTP_OK) {
$json = JsonHelper::getJson($response->getBody());
if (isset($json)) {
return new Topup($json);
}
} else {
return $response;
}
}
} catch (Exception $ex) {
echo $ex->getTraceAsString();
}
return null;
}
