Документация 1С-Битрикс: Модули artamonov.rest Функции и методы

Список функций

request()

Функция возвращает данные по текущему запросу.

МетодПараметрыОписание
get($code = "")$code - код параметраПараметры запроса
header($code = "")$header - код заголовкаЗаголовки запроса
method()Тип запроса
ip()IP-адрес клиента
path()Путь запроса
map()Карта роута для обработки запроса
// Пример возврата данных по текущему запросу
request()->get();

response()

Функция возвращает ответ клиенту. Имеется набор предустановленных ответов, которые реализованы согласно стандартам HTTP.

МетодПараметрыОписание
json($data = [], $statusCode = 200, $options = [], $headers = [])$data - данные ответа
$statusCode - код ответа
$options - параметры ответа (аналогичны функции json_encode)
$headers - дополнительные заголовки ответа
Возвращает ответ клиенту в JSON-формате
accepted()
badGateway()
badRequest($message = ”)
conflict()
created($data = [])
failedDependency()
forbidden()
gone()
httpVersionNotSupported()
internalServerError($message = ”)
invalidSslCertificate()
lengthRequired()
locked()
methodNotAllowed()
misdirectedRequest()
movedPermanently($location = ”)
multipleChoices()
noContent()
nonAuthoritativeInformation()
notAcceptable()
notFound()
notImplemented()
notModified()
ok($data = [])
partialContent($contentRange = ”)
payloadTooLarge($retryAfterSeconds = 60)
paymentRequired()
permanentRedirect($location = ”)
preconditionFailed()
processing()
requestedHostUnavailable()
resetContent()
seeOther($location = ”)
serviceUnavailable()
sslHandshakeFailed()
switchingProtocols($upgrade = ”)
temporaryRedirect($location = ”)
tooManyRequests()
unProcessableEntity()
unauthorized()
unavailableForLegalReasons()
unknownError()
unsupportedMediaType()
upgradeRequired()
uriTooLong()
useProxy($location = ”)
webServerIsDown()
// Пример возврата json-ответа с произвольными данными
response()->json($data);

// Пример возврата json-ответа = OK
response()->ok();

cache()

Функция для работы с системным кэшем. Является обёрткой над системным классом Cache. Используется кэш установленный в настройках системы.

МетодПараметрыОписание
get($id, $ttl = 86400, $dir = false)$id - идентификатор
$ttl - время жизни
$dir - директория
Получение кэша по ID, если кэша нет, тогда инициализирует его
set($data)$data - данные для кэшаСохранение кэша в ранее инициализированный кэш
clear($dir)$dir - директорияОчистка кэша
// Пример получения кеша
cache()->get($cacheId, $cacheTtl, $cacheDir);

journal()

Функция для работы с журналами.

МетодПараметрыОписание
add($type, $data = [], $clientId = ”)$type - тип журнала
$data - данные
$clientId - ID клиента
Запись данных в журнал
// Пример добавления записи в журнал
// Тип журнала Входящие запросы: request-response
journal()->add('request-response', \['request' => request()->get(), 'response' => $response]);

db()

Функция возвращает текущее подключение к базе данных. Является обёрткой над системным методом getConnection() класса Application.

МетодПараметрыОписание
query($sql)$sql - строка SQL-запросаВыполнение запроса
// Пример выполнения запроса
db()->query($sql);

token()

Функция для работы с токенами.

МетодПараметрыОписание
getData($token)$token - токен клиентаВозвращает информацию по токену
getDataByUserId($userId)$userId - ID пользователяВозвращает данные токена по ID пользователя
getExpirationDate($token)$token - токен клиентаВозвращает срок годности токена
updateExpirationDate($token)$token - токен клиентаОбновляет срок годности токена, согласно настройкам Безопасности модуля
delete($token)$token - токен клиентаУдаляет токен пользователя
generate($parameters = [], $update = false)$parameters - все те же ключи, что и для метода UserTable::getList()
$update - флаг для регулирования - обновлять уже созданные токены или же создать новые токены
Генерация токенов для пользователей
// Пример получения данных о токене
token()->getData('8f757146-097eb57b-b07d669e-112463ff');

// Пример генерации токенов
token()->generate(\['filter' => \['>ID' => 30]], true);