SetGroupPicture#
Метод устанавливает аватар группы.
Для метода используются ограничения на частоту запросов в секунду.
Запрос#
Для установки аватара группового чата требуется выполнить запрос по адресу:
POST
{{apiUrl}}/v3/waInstance{{idInstance}}/setGroupPicture/{{apiTokenInstance}} Для получения параметров запроса apiUrl, idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.
Параметры запроса#
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
file | file | Да | Отправляемый файл в формате *.jpg |
chatId | string | Да | Идентификатор группового чата |
Ответ#
Поля ответа#
| Поле | Тип | Описание |
|---|---|---|
setGroupPicture | boolean | флаг результата установки аватара группы |
urlAvatar | string | url на установленное изображение |
reason | string | причина почему аватар не был установлен |
Пример тела ответа#
Успешное выполнение метода#
{ "reason": "", "urlAvatar": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NotBPGJiDHPpKQP3fE_vh2BE1holGE_adbUwUqCIPQgiOI", "setGroupPicture": true } Выполнение метода с ошибкой#
status code 200
{ "reason": "", "urlAvatar": "", "setGroupPicture": false } Ошибки SetGroupPicture#
Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки
| Код HTTP | Идентификатор ошибки | Описание |
|---|---|---|
| 200 | { "reason": "Timed Out", "urlAvatar": null, "setGroupPicture": false } | Некорректный тип данных поля chatId либо некорректный chatId |
| 400 | Bad Request Validation failed | Ошибка валидации |
| 400 | File is empty | Пустой файл |
| 400 | Unsupported media type | Неподдерживаемый формат файла |
Примеры кода#
import requests url = "{{apiUrl}}/v3/waInstance{{idInstance}}/setGroupPicture/{{apiTokenInstance}}" payload = {( "chatId": "-10000000000000") } files=[ ('file',('{{file}}.jpeg',open('C:/{{file}}.jpeg','rb'),'image/jpeg')) ] headers = {} response = requests.post(url, json=payload) print(response.text.encode('utf8')) curl --location '{{apiUrl}}/v3/waInstance{{idInstance}}/setGroupPicture/{{apiTokenInstance}}' \ --form 'file=@"/E:/GreenApi_docs/green-api-logo.png"' \ --form 'chatId="-10000000000000"' var restTemplate = new RestTemplate(); var requestUrl = new StringBuilder(); requestUrl .append({{apiUrl}}) .append("/v3/waInstance").append({{idInstance}}) .append("/setGroupPicture/") .append({{apiTokenInstance}}); var headers = new HttpHeaders(); headers.setContentType(MediaType.MULTIPART_FORM_DATA); var form = new LinkedMultiValueMap<>(); form.add("file", new FileSystemResource(new File("/E:/GreenApi_docs/green-api-logo.png"))); form.add("chatId", -10000000000000); var requestEntity = new HttpEntity<>(form, headers); var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.POST, requestEntity, String.class); System.out.println(response); var requestUrl = new StringBuilder(); requestUrl .append({{apiUrl}}) .append("/v3/waInstance").append({{idInstance}}) .append("/setGroupPicture/") .append({{apiTokenInstance}}); var form = new HashMap<String, Object>(); form.put("file", new File("/E:/GreenApi_docs/green-api-logo.png")); form.put("chatId", dto.getchatId("-10000000000000"); var response = var response = Unirest.post(requestUrl.toString()) .fields(form) .asString(); System.out.println(response);