Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Этот класс содержит методы для работы с ответами REST. Объекты этого класса создаются во время выполнения метода execute() серверного класса SimpleRestRequest.
Пример
This server class allows you to operate with the REST responses.
SimpleRestResponse(response)
Objects of this class are created during the execution of the execute() method of the SimpleRestRequest server-side class.Return:
Example:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
const request = sws.restRequestV1(); request.setRequestUrl('https://jsonplaceholder.typicode.com/todos/1'); request.setRequestMethod('GET'); const response = request.execute(); |
getBody()
This method returns a response body.
Return:
Используйте метод, чтобы получить тело ответа.
Возвращаемое значение:
Тип | Описание |
---|---|
String | Метод возвращает тело ответа. |
ПримерExample:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
const request = sws.restRequestV1(); request.setRequestUrl('https://jsonplaceholder.typicode.com/todos/1'); request.setRequestMethod('GET'); const response = request.execute(); ss.info(response.getBody()); // Info: { // "userId": 1, // "id": 1, // "title": "delectus aut autem", // "completed": false // } |
getAllHeaders()
This method returns an array containing the response headers.
Return:
Используйте метод, чтобы получить объект, содержащий заголовки ответа.
Возвращаемое значение:
Тип | Описание |
---|---|
Object | Метод возвращает объекты заголовков ответа. Ключи – это названия заголовков, а значения – это массивы значений заголовков. |
ПримерExample:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
const request = sws.restRequestV1(); request.setRequestUrl('https://jsonplaceholder.typicode.com/todos/1'); request.setRequestMethod('GET'); const response = request.execute(); ss.info(response.getAllHeaders()); // InfoИнформация: {"http-code":["200"],"date":["Mon, 31... |
getContentBase64()
This method returns a base64 encoded content. Use it to get a file in binary format.
Return:
Используйте метод, чтобы получить содержимое ответа в кодировке base64. Используйте его, чтобы получить файл в двоичном формате.
Возвращаемое значение:
Тип | Описание |
---|---|
String | Метод возвращает содержимое ответа в кодировке base64. Метод возвращает null, если нет содержимого. |
ПримерExample:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
const simpleInstanceUri = ss.getProperty('simple.instance.uri'); const URL_BASE = (simpleInstanceUri.startsWith('https://')) ? simpleInstanceUri : `https://${simpleInstanceUri}`; const request = sws.restRequestV1(); request.setRequestUrl('https://s3-home.simpleone.ru/public-attachment/4/9f/istzt33ycijsiym7rv7ax92yd76l2arr?response-content-disposition=inline%3B%20filename%3D%22spacer24.gif%22&response-content-type=image%2Fgif%3B'); //the URL from which the file is downloaded const downloadResponse = request.execute(); request.setRequestUrl(`${URL_BASE}/v1/attachments/upload/user/${ss.getUserId()}`); // the URL, onкуда which the file is uploadedзагрузить файл request.setRequestHeader('Authorization', `Bearer ${new SimpleUser().getAccessToken()}`); request.addFileContent(downloadResponse.getContentBase64(), 'files', 'spacer24.gif'); const uploadResponse = request.execute(); |
getStatusCode()
This method returns the HTTP status code of the performed request.
Return:
Используйте метод, чтобы получить код состояния HTTP выполненного запроса.
Возвращаемое значение:
Тип | Описание |
---|---|
String | Метод возвращает код состояния HTTP. |
ПримерExample:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
const request = sws.restRequestV1(); request.setRequestUrl('https://jsonplaceholder.typicode.com/todos/1'); request.setRequestMethod('GET'); const response = request.execute(); ss.info(response.getStatusCode()); // InfoИнформация: 200 |
haveError()
This method displays an error notification if an error was reported during the REST transaction.
Return:
Используйте этот метод, чтобы проверить наличие ошибок, произошедших во время транзакции REST.
Возвращаемое значение:
Тип | Описание |
---|---|
Boolean | Метод возвращает true при наличии ошибок. Если ошибок не было, метод возвращает false. |
ПримерExample:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
const request = sws.restRequestV1(); request.setRequestUrl('https://jsonplaceholder.typicode.com/todos/1'); request.setRequestMethod('GET'); const response = request.execute(); ss.info(response.haveError()); // InfoИнформация: false |
Table of Contents | ||||
---|---|---|---|---|
|