mirror of
https://github.com/anthonyaxenov/atol-online.git
synced 2024-11-22 22:04:46 +00:00
58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# Обработка ответа API
|
||
|
||
[Вернуться к содержанию](readme.md#toc)
|
||
|
||
---
|
||
|
||
Объект класса `AtolOnline\Api\AtolResponse` возвращается всеми методами, которые обращаются к АТОЛ Онлайн API.
|
||
|
||
Поскольку классы `AtolOnline\Api\Fiscalizer` и `AtolOnline\Api\KktMonitor` наследуются от
|
||
абстрактного `AtolOnline\Api\AtolClient`, они оба предоставляют метод `getLastReponse()` для возврата последнего
|
||
полученного ответа от API.
|
||
|
||
Таким образом, а общем случае необязательно сразу сохранять ответ в переменную:
|
||
|
||
```php
|
||
$response = $kkt->sell($receipt);
|
||
```
|
||
|
||
Достаточно обратиться к нему позднее:
|
||
|
||
```php
|
||
$kkt->sell($receipt);
|
||
// ...
|
||
$response = $kkt->getLastResponse();
|
||
```
|
||
|
||
Однако, при сложной логике и многократных запросах следует пользоваться этим с умом и осторожностью.
|
||
|
||
Объект `AtolResponse` содержит в себе HTTP-код ответа, массив заголовков и JSON-декодированные данные тела ответа.
|
||
|
||
```php
|
||
$headers = $response->getHeaders(); // вернёт заголовки
|
||
$code = $response->getCode(); // вернёт код ответа
|
||
$body = $response->getContent(); // вернёт JSON-декодированный объект тела ответа
|
||
```
|
||
|
||
Обращаться к полям тела ответа можно опуская вызов метода `getContent()`:
|
||
|
||
```php
|
||
// вернёт значение поля uuid
|
||
$uuid = $response->getContent()->uuid;
|
||
$uuid = $response->uuid;
|
||
|
||
// вернёт текст ошибки
|
||
$err_text = $response->getContent()->error->text;
|
||
$err_text = $response->error->text;
|
||
```
|
||
|
||
Проверка успешности операции доступна через метод `isSuccessful()`:
|
||
|
||
```php
|
||
$response->isSuccessful(); // вернёт true, если ошибок нет
|
||
```
|
||
|
||
---
|
||
|
||
[Вернуться к содержанию](readme.md#toc)
|