/**
* 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;
}
