PHPackages                             carono/etxtru-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. carono/etxtru-api

ActiveLibrary

carono/etxtru-api
=================

etxt.ru php api client

1.0.1(7y ago)11361MITPHP

Since Oct 23Pushed 7y ago1 watchersCompare

[ Source](https://github.com/carono/etxtru-api)[ Packagist](https://packagist.org/packages/carono/etxtru-api)[ RSS](/packages/carono-etxtru-api/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/8d93ec9eee7fe340342cdc3513684b10b47e963bddf0d81a153fc4085fdc0e32/68747470733a2f2f706f7365722e707567782e6f72672f6361726f6e6f2f6574787472752d6170692f762f737461626c65)](https://packagist.org/packages/carono/etxtru-api)[![Total Downloads](https://camo.githubusercontent.com/4fa42461028b427d93b615d2364f4f2da6353c1b734574ceb5374f8a260374d8/68747470733a2f2f706f7365722e707567782e6f72672f6361726f6e6f2f6574787472752d6170692f646f776e6c6f616473)](https://packagist.org/packages/carono/etxtru-api)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/3ef4d5f655b4e0189c5a709a2c88cd0dc251eb4bf9985e2ec26bba1cfa2372fc/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6361726f6e6f2f6574787472752d6170692f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/carono/etxtru-api/?branch=master)[![License](https://camo.githubusercontent.com/37fdc25aa703256435e2ef9f0edc1f90684921e7b1577412efe093b9d2b3bdad/68747470733a2f2f706f7365722e707567782e6f72672f6361726f6e6f2f6574787472752d6170692f6c6963656e7365)](https://packagist.org/packages/carono/etxtru-api)

Введение
========

[](#введение)

Данный клиент разработан для работы с сайтом .
Класс клиента генерируется автоматически на основе документации

Инсталяция
==========

[](#инсталяция)

`composer require carono/etxtru-api`

Использование
=============

[](#использование)

```
// Получение баланса

require '../vendor/autoload.php';

$client = new \carono\etxtru\Client();
$client->apiKey = 'token';
$client->password = 'password';

$response = $client->users()->getBalance();

// Создание заказа

$config = new \carono\etxtru\config\TasksSaveTaskConfig();
$config->public = 0;
$config->title = 'Задача 1';
$config->description = 'Описание';
$config->price = 5;
$config->price_type = 1;
$config->size = 500;
$config->id_folder = 'folder_name';
$config->deadline = '30.10.2018';
$config->id_category = 1938;
$config->file = fopen('/path/file.jpg', 'rb');

$response = $client->tasks()->saveTask($config);
```

Функция возвращает список тематических категорий заказов/статей
===============================================================

[](#функция-возвращает-список-тематических-категорий-заказовстатей)

```
$client->categories();
```

Доступные методы
----------------

[](#доступные-методы)

**listCategories** - Возвращает список тематический категорий заказов/статей, отсортированный по названию категории.

```
$client->categories()->listCategories();
```

#### Результат

[](#результат)

ПараметрОписаниеid\_categoryИдентификатор категорииid\_parentИдентификатор родительской категорииnameНазвание категорииkeywordКлючевое слово категории---

Функция возвращает список папок текущего пользователя
=====================================================

[](#функция-возвращает-список-папок-текущего-пользователя)

```
$client->folders();
```

Доступные методы
----------------

[](#доступные-методы-1)

**listFolders** - Возвращает отсортированный список папок текущего пользователя.

```
$client->folders()->listFolders($sort);
```

#### Входные параметры

[](#входные-параметры)

ПараметрТипОписаниеsortstringdate - сортировка по дате создания, name - по названию (по умолчанию)#### Результат

[](#результат-1)

ПараметрОписаниеid\_categoryИдентификатор папкиid\_parentИдентификатор родительской папкиnameНазвание папкиdepthГлубина вложенности папкиlastФлаг, является ли папка последней по глубине вложенности---

**addFolder** - Cоздает папку для текущего пользователя.

```
$client->folders()->addFolder($name, $id_parent);
```

#### Входные параметры

[](#входные-параметры-1)

ПараметрТипОписаниеnamestringНазвание создаваемой папки (длинна от 1 до 128 знаков)id\_parentintИдентификатор родительской папки или 0 (по умолчанию) для корневой папки#### Результат

[](#результат-2)

ПараметрОписаниеid\_folderИдентификатор созданной папки---

**moveToFolder** - Фукнция перемещает объекты в папку.

```
$client->folders()->moveToFolder($id_folder, $type, $ids);
```

#### Входные параметры

[](#входные-параметры-2)

ПараметрТипОписаниеid\_folderstringИдентификатор папкиtypestringТип перемещаемых объектов. Значения: task - заказ archive - архивный заказ article - статья article\_archive - архивная статья correction - коррекция bhv\_task - заданияidsint (array)Массив идентификаторов перемещаемых объектов#### Результат

[](#результат-3)

ПараметрОписаниеcountКоличество перемещенных объектов---

Функция возвращает список исполнителей
======================================

[](#функция-возвращает-список-исполнителей)

```
$client->users();
```

Доступные методы
----------------

[](#доступные-методы-2)

**getList** - Возвращает список исполнителей без сортировки.

```
$client->users()->getList($config);
```

#### Входные параметры

[](#входные-параметры-3)

ПараметрТипОписаниеcountintЧисло пользователей для выборке, не более 100 за запрос (по умолчанию)fromintСмещение от последней записи в выборке, по умолчанию 0rate\_fromintФильтрация по рейтингу, начиная с данного значенияrate\_outintФильтрация по рейтингу, заканчивая данным значениемonlineintФлаг онлайн статуса на бирже, 1 - онлайн, 0 - офлайн, по умолчанию все вместе#### Результат

[](#результат-4)

ПараметрОписаниеid\_userИдентификатор пользователяloginЛогин пользователяfioФИО пользователяdescriptionДополнительная информация о пользователеcountryСтрана пользователяcityГород пользователяonlineОнлайн статус пользователя (1 - онлайн, 0 - оффлайн)regdateДата регистрации пользователя, unixtimerateРейтинг пользователя---

**getBW** - Функция возвращает список пользователей, находящихся в черном и белом списке текущего пользователя.

```
$client->users()->getBW($count, $from, $id_group, $type);
```

#### Входные параметры

[](#входные-параметры-4)

ПараметрТипОписаниеcountintЧисло пользователей для выборке, не более 100 за запрос (по умолчанию)fromintСмещение от последней записи в выборке, по умолчанию 0id\_groupintИдентификатор группы БС/ЧС, если не определен, то выборка по параметру typetypestringТип списка (whiteList - белый список, blackList - черный), по умолчанию все вместе#### Результат

[](#результат-5)

ПараметрОписаниеid\_userИдентификатор пользователяid\_groupИдентификатор группы спискаloginЛогин пользователяfioФИО пользователяonlineОнлайн-статус пользователя (1 - онлайн, 0 - оффлайн)typeТип списка (whiteList - белый список, blackList - черный)---

**getNote** - Функция возвращает примечание к указанному пользователю.

```
$client->users()->getNote($id);
```

#### Входные параметры

[](#входные-параметры-5)

ПараметрТипОписаниеidintИдентификатор пользователя, обязательный параметр#### Результат

[](#результат-6)

ПараметрОписаниеid\_userИдентификатор пользователяtextТекст примечанияdateДата последнего изменения примечания, unixtime---

**getUser** - Функция возвращает подробную информацию об указанном пользователе.

```
$client->users()->getUser($id, $login);
```

#### Входные параметры

[](#входные-параметры-6)

ПараметрТипОписаниеidintИдентификатор пользователя, полуобязательный параметр, имеет приоритет над параметром loginloginstringЛогин пользователя, полуобязательный параметр, может указываться при отсутствии параметра id#### Результат

[](#результат-7)

ПараметрОписаниеid\_userИдентификатор пользователяloginЛогин пользователяfioФИО пользователяdescriptionДополнительная информация о пользователеcountryСтрана пользователяcityГород пользователяonlineОнлайн-статус пользователя (1 - онлайн, 0 - оффлайн)regdateДата регистрации пользователя, unixtimerateРейтинг пользователяphotoПуть до аватара пользователяgroupНазвание группы пользователяworksВиды указанных пользователем работ, только для исполнителяcategoriesКатегории, указанные пользователем, только для исполнителяlangsЯзыки, указанные пользователем, только для исполнителяportfolioЧисло работ в портфолио, только для исполнителя---

**getWorks** - Функция возвращает виды работ и минимальные цены исполнителя по ним.

```
$client->users()->getWorks($id);
```

#### Входные параметры

[](#входные-параметры-7)

ПараметрТипОписаниеidintИдентификатор пользователя (исполнителя), обязательный параметр#### Результат

[](#результат-8)

ПараметрОписаниеworksМассив ассоциативных пар значений \[id\_type => вид работы (1 - копирайтинг, 2 - рерайтинг, 3 - перевод, 4 - SEO копирайтинг), minprice => минимальная цена исполнителя (0 - цена не ограничена)\]. Ключ элемента совпадает с id\_type.---

**getReports** - Функция возвращает отзывы указанного незаблокированного пользователя. Отзывы разделены на два массива - negative (отрицательные отзывы) и positive (положительные) и сгруппированы по авторам.

```
$client->users()->getReports($id);
```

#### Входные параметры

[](#входные-параметры-8)

ПараметрТипОписаниеidintИдентификатор пользователя, обязательный параметр#### Результат

[](#результат-9)

ПараметрОписаниеid\_authorИдентификатор автора отзываtextТекст отзываdateДата отзыва, unixtime---

**setReport** - Функция добавляет/редактирует отзыв пользователю.

```
$client->users()->setReport($config);
```

#### Входные параметры

[](#входные-параметры-9)

ПараметрТипОписаниеidintИдентификатор пользователя, кому отзывidintИдентификатор пользователя, кому отзывid\_reportintИдентификатор редактируемого отзыва, время для редактирования - 1 час от начала публикацииtextstringТекст отзыва, 50-5000 символовrateintТип отзыва: 1 - положительный (по умолчанию), 2 - отрицательный#### Результат

[](#результат-10)

ПараметрОписаниеid\_reportИдентификатор созданного/измененного отзыва---

**getUserBW** - Функция возвращает количество белых и черных списков, в которых находится пользователь.

```
$client->users()->getUserBW($id);
```

#### Входные параметры

[](#входные-параметры-10)

ПараметрТипОписаниеidintИдентификатор пользователя, обязательный параметр#### Результат

[](#результат-11)

ПараметрОписаниеid\_userИдентификатор пользователя, у которого считаем (повторяет входящий параметр)whiteListЧисло пользователей, у которых запрашиваемый пользователь в белом спискеblackListЧисло пользователей, у которых запрашиваемый пользователь в черном списке---

**setUserBW** - Функция добавляет или удаляет пользователя в черный/белый список.

```
$client->users()->setUserBW($id, $id_group, $type);
```

#### Входные параметры

[](#входные-параметры-11)

ПараметрТипОписаниеidintИдентификатор добавляемого/удаляемого пользователя, обязательный параметрid\_groupintИдентификатор группы БС/ЧС, если не определен, то "без группы"typestringТип действия: whiteList - в белый список, blackList - в черный, delete - удалить из списка#### Результат

[](#результат-12)

ПараметрОписаниеidИдентификатор пользователя, над которым производим действие (повторяет входящий параметр)typeНазвание выполненного действия---

**getBalance** - Функция возвращает состояние лицевого счета текущего пользователя.

```
$client->users()->getBalance();
```

#### Результат

[](#результат-13)

ПараметрОписаниеidИдентификатор текущего пользователяbalanceДоступная сумма в рублях на лицевом счетаdateТекущая дата запроса---

Функция возвращает список заказов текущего пользователя, только для заказчика
=============================================================================

[](#функция-возвращает-список-заказов-текущего-пользователя-только-для-заказчика)

```
$client->tasks();
```

Доступные методы
----------------

[](#доступные-методы-3)

**listTasks** - Возвращает список заказов текущего пользователя, только для заказчика.

```
$client->tasks()->listTasks($config);
```

#### Входные параметры

[](#входные-параметры-12)

ПараметрТипОписаниеcountintЧисло пользователей для выборки, не более 100 за запрос (по умолчанию)fromintСмещение от последней записи в выборке, по умолчанию 0idintИдентификатор конкретного заказа, будет возвращен только этот заказid\_userintИдентификатор исполнителя заказа, при указании этого параметра будет фильтрация заказов по данному полюid\_folderintИдентификатор папки проекта (фильтрация по папке)statusintФильтрация по статусу заказа, по умолчанию все заказы. Если указан статус "1", то дополнительно накладывается выдача только публикуемых заказов (не черновиков!) Значения: 1 - ожидание выбора исполнителя 2 - принят к исполнению 3 - на проверке 4 - выполнен 5 - просроченfilterintФлаг общей фильтрации, по умолчанию все заказы. Исключает фильтрацию по статусу (если указан корректный параметр filter, то параметр status игнорируется) Значения: 10 - просроченные заказы в работе, по которым не принято решениеtargetintФильтрация по уровню доступа заказа для исполнителя Значения: 1 - Общий заказ 2 - Заказ для белого списка 3 - Индивидуальный заказonly\_idintЕсли флаг указан и имеет значение 1, то будут возвращены только id заказов, а не вся информация. Параметр необязательный.#### Результат

[](#результат-14)

ПараметрОписаниеidИдентификатор заказаid\_userИдентификатор исполнителя, если не назначен, то значение 0id\_folderИдентификатор папкиid\_categoryИдентификатор категорииdateДата создания/редактирования заказа, unixtimeend\_dateДата принятия заказа, unixtime, если не принят, то 0titleНазвание заказаdescriptionОписание заказаid\_typeТип заказа (1 - копирайтинг, 2 - рерайтинг, 3 - перевод, 4 - SEO копирайтинг)id\_subtypeТип текста (0 - не указан, 1 - продающий текст, 2 - информационная статья, 3 - новость/пресс-релиз, 4 - текст для email-рассылки, 5 - текст для соцсетей, 6 - отзыв)id\_levelУровень сложности заказа (0 - без квалификации, 1 - начальный уровень, 2 - средний уровень, 3 - высокий уровень)deadlineСрок сдачи заказа, unixtimestatusСтатус заказа (1 - ожидание выбора исполнителя, 2 - принят к исполнению, 3 - на проверке, 4 - выполнен, 5 - просрочен)publicФлаг публикации заказа (1 - публикуется, 0 - нет)priceПолная цена заказа, вне зависимости от типа ценыprice\_typeТип цены заказа (1 - за 1000 символов, 2 - за весь заказ)sizeРазмер заказа в символахwhitespacesФлаг учета пробелов (0 - без пробелов, 1 - с пробелами)checksizeФлаг проверки объема результата при сдаче (требование не менее 90%) - (0 - не проверять, 1 - проверять)textТекст заказаquickФлаг срочности заказа (1 - срочный, 0 - не срочный)uniqТребование уникальности результата для автоматической отправки на доработку, если поле отсутствует, то параметр в заказе не указанtargetФлаг уровня доступа заказа для исполнителяid\_targetИдентификатор пользователя в случае индивидуального заказа, если поле отсутствует, то заказ не индивидуальныйkeywordsСписок ключевых слов при типе задания "СЕО-копирайтинг"language\_fromlanguage\_toИдентификаторы языков переводов при типе задания "Перевод"multitaskФлаг, является ли заказ мультизаказом (1 - да, 0 - во всех остальных случаях)multicountЧисло оставшихся заказов при мультизаказе (которые можно создать при принятии заявки от исполнителя на мультизаказ), при достижении 0 мультизаказ автоматически снимается с публикацииfilenameАдрес вложенного в заказ файла, если его нет, то поле отсутствует---

**viewNotes** - Функция возвращает список заявок и комментариев на указанный заказ (или список заказов) текущего пользователя, только для заказчика.

```
$client->tasks()->viewNotes($id);
```

#### Входные параметры

[](#входные-параметры-13)

ПараметрТипОписаниеidint (array)Идентификатор заказа (-ов, но не более 100), обязательный параметр#### Результат

[](#результат-15)

ПараметрОписаниеidИдентификатор комментарияtextТекст заявкиdateДата заявки, unixtimeid\_userИдентификатор автора комментария/заявкиloginЛогин автора комментария/заявкиid\_noteИдентификатор заявки, если заявка отсутствует, то есть запись - просто комментарий, то значение поля 0id\_taskИдентификатор заказа---

**viewNotesAll** - Функция возвращает список всех поданных заявок на все заказы текущего заказчика.

```
$client->tasks()->viewNotesAll();
```

#### Результат

[](#результат-16)

ПараметрОписаниеid\_noteИдентификатор заявкиtitleНазвание заказаpriceЦена заказаdeadlineСрок сдачи заказа, unixtimeid\_taskИдентификатор заказаid\_userИдентификатор исполнителяuserЛогин исполнителяdateДата заявки, unixtimetextТекст заявки---

**setNote** - Функция принятия указанной заявки на заказ, только для заказчика.

```
$client->tasks()->setNote($id, $comment);
```

#### Входные параметры

[](#входные-параметры-14)

ПараметрТипОписаниеidintИдентификатор заявки (не комментария!), обязательный параметрcommentstringКомментарий при принятии заявки, добавляется в конец описания заказа, не более 500 символов#### Результат

[](#результат-17)

ПараметрОписаниеid\_taskИдентификатор заказа, если заявка принадлежит мультизаказу, то индентификатор нового созданного заказа, иначе того, на который заявка принятаid\_userИдентификатор пользователя, назначенного исполнителем по принятой заявке---

**unsetNote** - Функция отклонения указанной заявки на заказ, только для заказчика.

```
$client->tasks()->unsetNote($id);
```

#### Входные параметры

[](#входные-параметры-15)

ПараметрТипОписаниеidintИдентификатор заявки (не комментария!), обязательный параметр#### Результат

[](#результат-18)

ПараметрОписаниеid\_taskИдентификатор заказа, которому принадлежит отклоненная заявкаid\_userИдентификатор пользователя, заявку которого отклонили---

**paidTask** - Функция принятия заказа на проверке, только для заказчика.

```
$client->tasks()->paidTask($id);
```

#### Входные параметры

[](#входные-параметры-16)

ПараметрТипОписаниеidarray (int var1, int var2, ... )Массив идентификаторов принимаемых заказов вида id\[\]=1&id\[\]=2, обязательный параметр#### Результат

[](#результат-19)

ПараметрОписаниеstatusФлаг успешности принятияidsМассив идентификаторов принятых заказов---

**cancelTask** - Функция отправки заказа на проверке на доработку, только для заказчика.

```
$client->tasks()->cancelTask($id, $text);
```

#### Входные параметры

[](#входные-параметры-17)

ПараметрТипОписаниеidarray (int var1, int var2, ... )Массив идентификаторов отклоняемых заказов вида id\[\]=1&id\[\]=2, обязательный параметрtextstringКомментарий к отклонению, обязателен, если отклоняется 1 заказ, а не пакет заказов, иначе обнуляется#### Результат

[](#результат-20)

ПараметрОписаниеstatusФлаг успешности принятияidsМассив идентификаторов отклоненных заказов---

**getResults** - Функция получения результатов по заказам, только для заказчика.

```
$client->tasks()->getResults($id);
```

#### Входные параметры

[](#входные-параметры-18)

ПараметрТипОписаниеidarray (int var1, int var2, ...)Массив идентификаторов заказов, обязательный параметр#### Результат

[](#результат-21)

ПараметрОписаниеidИдентификатор результатаid\_taskИдентификатор заказаid\_userИдентификатор пользователя, сдавшего результатcommentКомментарий пользователя к сдаче результатаdateДата сдачи результата, unixtimedate\_resetДата отправки результата на доработку, unixtimestatusСтатус результата (0 - на проверке, 1 - отклонен, 2 - принят)checkФлаг проверки результата системой (0 - не проверено, 1 - проверено)filesМассив файлов результата, ссылки на файлы действительны примерно суткиper\_keywordsПроцент вхождения указанных ключевых слов, только для типа заказов SEO-копирайтингper\_mistakesПроцент орфографических ошибок после проверки системой по внутреннему словарюper\_antiplagiatПроцент уникальности текстаper\_diffПроцент схожести с исходником, только для типа заказов рерайтинг и при приложенном исходном текстеauto\_check\_dateДата проверки результата системой, unixtimenameТип приложенного документаsizeРазмер приложенного файлаpathПуть для скачивания результата, действительно примерно сутки с момента осуществления запроса---

**deleteTask** - Функция удаления заказов в статусе ожидания исполнителя или из черновика, только для заказчика. Запрещено удалять заказы в течение недели после снятия исполнителя с заказа.

```
$client->tasks()->deleteTask($id);
```

#### Входные параметры

[](#входные-параметры-19)

ПараметрТипОписаниеidarray (int var1, int var2, ...)Массив идентификаторов заказов, обязательный параметр#### Результат

[](#результат-22)

ПараметрОписаниеidsМассив идентификаторов удаленных заданий---

**extraPaid** - Функция начисления доплаты по заданию.

```
$client->tasks()->extraPaid($id, $count, $note, $autopay);
```

#### Входные параметры

[](#входные-параметры-20)

ПараметрТипОписаниеidintИдентификатор заданияcountintСумма доплаты, не более стоимости заказа \* 3noteintПосылать уведомление исполнителю, по умолчанию 1 (1 - да, 0 - нет)autopaystringРасчет доплаты автоматически, по числу превышения знаков у последнего результата (get - получить расчет доплаты, pay - произвести доплату), по умолчанию размер доплаты берется из параметра count#### Результат

[](#результат-23)

ПараметрОписаниеstatusФлаг успешности зачисленияcountРазмер доплаты. Возвращается если установлен параметр autopay=get---

**saveTask** - Функция добавления/редактирования заказа, только для заказчика.

```
$client->tasks()->saveTask($config);
```

#### Входные параметры

[](#входные-параметры-21)

ПараметрТипОписаниеidintИдентификатор редактируемого заказа, если не указан, то заказ будет создан новыйpublicintФлаг публикации заказа (0 - не публикуется, 1 - публикуется)titlestringНазвание заказа, не более 512 символов, обязательный параметрdescriptionstringОписание заказа, не более 5000 символовtextstringТекст заказа, не более 40000 символовpriceintЦена заказа, обязательный параметрprice\_typeintТип цены заказа (1 - за 1000 знаков, 2 - за весь заказ)uniqintТребуемая уникальность заказа, по умолчанию не определенаwhitespacesintФлаг с учетом пробелов или нет (0 - без пробелов, 1 - с пробелами)only\_starsintФлаг учета уровня мастерства исполнителя (0 - без учета, 1 - с учетом)sizeintРазмер заказа в символах, обязательный параметр при отсутствии параметра textchecksizeintФлаг учета минимального размера результата сдачи в 90% (1 - включено и тексты менее 90% от размера заказа приниматься не будут, 0 - выключено)id\_typeintИдентификатор типа заказа, по умолчанию 1 (копирайтинг)id\_subtypeintТип текста, необязательный параметр (0 по умолчанию). Значения: 1 - продающий текст, 2 - информационная статья, 3 - новость/пресс-релиз, 4 - текст для email-рассылки, 5 - текст для соцсетей, 6 - отзывdeadlinestringСрок сдачи заказа в формате дд.мм.гггг, не более 90 днейtimelinestringВремя сдачи заказа в формате чч:ммauto\_workintФлаг автопринятия заявки в заказе (1 - автопринятие, 0 - нет)auto\_rateintРейтинг для автопринятия заказа, по умолчанию 0auto\_reportsintЧисло положительных отзывов для автопринятия заказа (не менее), 0 по умолчаниюauto\_reports\_nintЧисло отрицательных отзывов для автопринятия заказа (не более), по умолчанию параметр отсутствует, может быть 0auto\_levelintИдентификатор уровня мастерства исполнителя для автопринятия заказа, по умолчанию 0 (без квалификации)id\_categoryintИдентификатор категории заказа, обязательное полеmultitaskintФлаг мультизаказа (1 - мультизаказ, 0 - обычный)multicountintЧисло мультизаказовid\_folderintИдентификатор папки заказаtarget\_taskintФлаг доступности заказа (1 - для всех, 2 - для белого списка, 3 - индивидуальный заказ)id\_targetintИдентификатор пользователя, для кого выставлен индивидуальный заказ, или группы БС - если заказ выставляется для конкретной группыkeywordsstringСписок ключевых слов через запятую для типа заказа SEO-копирайтинг (4)language\_fromintИдентификатор языка, откуда осуществлять перевод, для типа заказа по переводу (3)language\_tointИдентификатор языка, на который осуществлять перевод, для типа заказа по переводу (3)bwgroup\_sendintФлаг (1 - посылать, 0 или не указан - не посылать), посылать ли уведомление группе из БС о выставлении для них заказа (параметры target\_task = 2, id\_target = ИД группы БС)filefileПрилагаемый файл заказа#### Результат

[](#результат-24)

ПараметрОписаниеid\_tasksИдентификатор созданного или отредактированного заказа---

**failTask** - Функция отмены просроченного заказа, только для заказчика. Отмененный заказ невозможно удалить, он будет существовать для истории 2 недели, после чего удалится автоматически.

```
$client->tasks()->failTask($id, $copy, $deadline, $timeline);
```

#### Входные параметры

[](#входные-параметры-22)

ПараметрТипОписаниеidintИдентификатор просроченного заказа, обязательный параметрcopyintФлаг создания копии отменяемого заказа, если указано и значение 1, то создастся публикуемая копия заказа со сроком, задаваемым параметрами нижеdeadlinestringНовый срок сдачи в формате дд.мм.гггг, по умолчанию - текущее время плюс 5 суток для несрочного заказа или 5 часов для срочногоtimelinestringНовое время сдачи в формате чч:мм, 23:59 по умолчанию#### Результат

[](#результат-25)

ПараметрОписаниеidИдентификатор отмененного заказаid\_copyИдентификатор созданной копии заказа, если указано копированиеrateupСсылка для восстановления рейтинга исполнителю---

**copyTask** - Функция копирования заказа, только для заказчика. Новый заказ будет публикуемым и доступный исполнителям, настройки автопринятия и мультизаказа не копируются.

```
$client->tasks()->copyTask($id, $deadline, $timeline);
```

#### Входные параметры

[](#входные-параметры-23)

ПараметрТипОписаниеidintИдентификатор копируемого заказа, обязательный параметрdeadlinestringНовый срок сдачи в формате дд.мм.гггг, не более 90 дней, по умолчанию или если некорректное - текущее время плюс 5 суток для несрочного заказа или 5 часов для срочногоtimelinestringНовое время сдачи в формате чч:мм, 23:59 по умолчанию#### Результат

[](#результат-26)

ПараметрОписаниеid\_copyИдентификатор созданной копии заказа---

**setDeadline** - Функция увеличения срока сдачи заказа, только для заказчика. Если заказ просроченный, то он будет возвращен в работу, если в черновике, то возможна его публикации для ожидания подачи заявок.

```
$client->tasks()->setDeadline($id, $deadline, $timeline, $public);
```

#### Входные параметры

[](#входные-параметры-24)

ПараметрТипОписаниеidintИдентификатор заказа, обязательный параметрdeadlinestringНовый срок сдачи заказа в формате дд.мм.гггг (25.10.2013), должен быть не меньше текущего, но не более 90 дней, обязательный параметр.timelinestringНовое время сдачи заказа в формате чч:мм (12:16), если не указано, то будет 23:59, необязательный параметрpublicintФлаг публикации черновика, если 1, то заказ-черновик будет опубликован, иначе статус публикации не изменится#### Результат

[](#результат-27)

ПараметрОписаниеdeadlineУстановленная дата и время сдачи заказаidИдентификатор заказаstatusТекущий статус заказа (например, был 5 - просроченный, после продления станет 2 - в работе)quickФлаг срочности заказа, 1 - срочный, 0 - нет---

**saveComment** - Функция добавления комментария в заказ, только для заказчика или назначенного исполнителя.

```
$client->tasks()->saveComment($id, $text, $hide);
```

#### Входные параметры

[](#входные-параметры-25)

ПараметрТипОписаниеidintИдентификатор заказа, обязательный параметрtextstringТекст комментария, максимум 2048 символов, обязательный параметр.hideintФлаг скрытия текста комментария (1 - скрывать, 0 или отсутствует - не скрывать), необязательный параметр#### Результат

[](#результат-28)

ПараметрОписаниеidИдентификатор заказаid\_commentИдентификатор добавленного комментарияcommentsЧисло комментариев в заказе---

**sendNoteFail** - Функция создает заявку в обратную связь на снятие исполнителя с заказа.

```
$client->tasks()->sendNoteFail($id, $text);
```

#### Входные параметры

[](#входные-параметры-26)

ПараметрТипОписаниеidintИдентификатор заказа, с которого снимать исполнителя, заказ должен быть в статусе "На проверке" и текущий исполнитель должен иметь хоть один сданный результат.textstringТекст заявки на снятие, причины, недочеты.#### Результат

[](#результат-29)

ПараметрОписаниеstatusФлаг успешного создания заявкиticketСсылка на созданный тикет в обратную связь---

Функция получения списка заказов из архива заказов, только для заказчика
========================================================================

[](#функция-получения-списка-заказов-из-архива-заказов-только-для-заказчика)

```
$client->tasksArchive();
```

Доступные методы
----------------

[](#доступные-методы-4)

**listTasks** - Возвращает список архивных заказов текущего пользователя, только для заказчика.

```
$client->tasksArchive()->listTasks($config);
```

#### Входные параметры

[](#входные-параметры-27)

ПараметрТипОписаниеcountintЧисло пользователей для выборке, не более 100 за запрос (по умолчанию)fromintСмещение от последней записи в выборке, по умолчанию 0orderstringПорядок сортировки, возможные значения: desc, asc (по умолчанию)idintИдентификатор конкретного заказа, будет возвращен только этот заказid\_folderintИдентификатор папки проекта (фильтрация по папке)id\_userintИдентификатор исполнителя заказа, при указании этого параметра будет фильтрация заказов по данному полю#### Результат

[](#результат-30)

ПараметрОписаниеidИдентификатор заказаid\_userИдентификатор исполнителя, если не назначен, то значение 0id\_folderИдентификатор папкиid\_categoryИдентификатор категорииdateДата создания/редактирования заказа, unixtimetitleНазвание заказаdescriptionОписание заказаid\_typeТип заказа (1 - копирайтинг, 2 - рерайтинг, 3 - перевод, 4 - SEO копирайтинг)id\_levelУровень сложности заказа (0 - без квалификации, 1 - начальный уровень, 2 - средний уровень, 3 - высокий уровень)deadlineСрок сдачи заказа, unixtimepriceЦена заказаprice\_typeТип цены заказа (1 - за 1000 символов, 2 - за весь заказ)sizeРазмер заказа в символахwhitespacesФлаг учета пробелов (0 - без пробелов, 1 - с пробелами)textТекст заказаend\_dateДата окончания (принятия) заказа, unixtimedate\_archiveДата переноса заказа в архив, unixtimekeywordsСписок ключевых слов при типе задания "СЕО-копирайтинг"language\_fromlanguage\_toЯзыки переводов при типе задания "Перевод"---

**getResults** - Функция получения результатов по архивному заказу, только для заказчика.

```
$client->tasksArchive()->getResults($id);
```

#### Входные параметры

[](#входные-параметры-28)

ПараметрТипОписаниеidintИдентификатор заказа, обязательный параметр#### Результат

[](#результат-31)

ПараметрОписаниеid\_taskИдентификатор заказаid\_userИдентификатор пользователя, сдавшего результатcommentКомментарий пользователя к сдаче результатаcontentТекст результатаdateДата сдачи результата, unixtimedate\_resetДата отправки результата на доработку, unixtimecheckМассив параметров проверки результата системойfilesМассив файлов результата, ссылки на файлы действительны примерно сутки---

Функция получения списка языков, используемых в системе
=======================================================

[](#функция-получения-списка-языков-используемых-в-системе)

```
$client->options();
```

Доступные методы
----------------

[](#доступные-методы-5)

**getLangs** - Функция получения списка языков, используемых в системе.

```
$client->options()->getLangs();
```

#### Результат

[](#результат-32)

ПараметрОписаниеidИдентификатор статьиtitleНазвание статьиdescriptionЗакодированная в base64 картинка описания статьи (формат картинки png)keywordsКлючевые слова статьиdateДата добавления статьи, unixtimedate\_buyДата покупки статьи, unixtime (только для купленной, при filter=1)id\_typeИдентификатор типа текста статьиid\_subtypeИдентификатор типа статьи (1 - общая статья, 2 - новость, 3 - описание товара для интернет-магазина, 4 - обзор товара, 5 - кулинарный рецепт, 6 - мастер-классы (рукоделие, поделки и проч.), 7 - пресс-релиз, 8 - эссе, 9 - статья для главной страницы сайта, 10 - лирика (стихотворение))id\_folderИдентификатор папки купленной статьиid\_categoryИдентификатор категории статьиid\_languageИдентификатор языка текста статьиfull\_priceЦена статьи, включая комиссию для покупателя (с учетом возможной скидки)discountРазмер скиди для статьи в процентахdate\_discountДата до которой действует скидка (включительно)sizeЧисло символов в статьеimagesЧисло изображений в статьеunqУникальность статьи в % (проверка на рерайтинг и проверка на копии)unq\_shinУникальность статьи в % (проверка на рерайтинг и проверка на копии)moder\_checkФлаг проверки статьи (авто)модератором на качествоmoder\_orphОценка орфографии (1 - без ощибок, 0 - с ошибками)moder\_puncОценка пунктуации и грамматики (1 - без ощибок, 0 - с ошибками)moder\_styleОценка стилистики (1 - без ощибок, 0 - с ошибками)---

Функция получения списка готовых статей на продажу
==================================================

[](#функция-получения-списка-готовых-статей-на-продажу)

```
$client->articles();
```

Доступные методы
----------------

[](#доступные-методы-6)

**getList** - Возвращает список готовых статей на продажу. Поле "Описание статьи" не выводится во избежание автоматической выемки всех описаний статей.

```
$client->articles()->getList($config);
```

#### Входные параметры

[](#входные-параметры-29)

ПараметрТипОписаниеcountintЧисло статей для выборке, не более 20 за запрос (по умолчанию)fromintСмещение от последней записи в выборке, по умолчанию 0id\_userintИдентификатор автора статьи для фильтрации спискаid\_categoryintИдентификатор категории статьи для фильтрации спискаsubcatintОпция поиска в подкатегориях (1 - искать в подкатегориях, 0 - нет, по умолчанию)id\_subtypeintИдентификатор типа статьи для фильтрации списка (от 1 до 10)filterintФлаг показа купленных статей текущим пользователем, если указано 1, то будут выбраны только купленные статьи текущим пользователем, иначе только статьи на продажуidintИдентификатор статьи: будет выбрана только указанная статьяtextstring (40)Строка для поиска по названию, описанию и ключевым словамprice\_fromintФильтрация по цене, от ... до, если указан параметр price\_type (любое значение), то поиск по цене за 1000 знаковprice\_tointФильтрация по цене, от ... до, если указан параметр price\_type (любое значение), то поиск по цене за 1000 знаковprice\_typeintФильтрация по цене, от ... до, если указан параметр price\_type (любое значение), то поиск по цене за 1000 знаковsize\_fromintФильтрация по размеру текста, от ... доsize\_tointФильтрация по размеру текста, от ... доuniq\_fromintФильтрация по уникальности статьи, от ... доuniq\_tointФильтрация по уникальности статьи, от ... доid\_languageintФильтрация по языку статьи, список идентификаторов options.getLangs, если 0 или ошибочен, то без учета параметраsortstringСортировка статей, значения: relevancy (по релевантности при поиске по тексту), title (по названию), price (по цене), size (по размеру), uniq (по уникальности), date (по дате добавления - по умолчанию)orderstringПорядок сортировки статей, только при заданном параметре sort, значения: desc (по убыванию), asc (по возрастанию)#### Результат

[](#результат-33)

ПараметрОписаниеidИдентификатор статьиtitleНазвание статьиdescriptionЗакодированная в base64 картинка описания статьи (формат картинки png)keywordsКлючевые слова статьиdateДата добавления статьи, unixtimedate\_buyДата покупки статьи, unixtime (только для купленной, при filter=1)id\_typeИдентификатор типа текста статьиid\_subtypeИдентификатор типа статьи (1 - общая статья, 2 - новость, 3 - описание товара для интернет-магазина, 4 - обзор товара, 5 - кулинарный рецепт, 6 - мастер-классы (рукоделие, поделки и проч.), 7 - пресс-релиз, 8 - эссе, 9 - статья для главной страницы сайта, 10 - лирика (стихотворение))id\_folderИдентификатор папки купленной статьиid\_categoryИдентификатор категории статьиid\_languageИдентификатор языка текста статьиfull\_priceЦена статьи, включая комиссию для покупателя (с учетом возможной скидки)discountРазмер скиди для статьи в процентахdate\_discountДата до которой действует скидка (включительно)sizeЧисло символов в статьеimagesЧисло изображений в статьеunqУникальность статьи в % (проверка на рерайтинг и проверка на копии)unq\_shinУникальность статьи в % (проверка на рерайтинг и проверка на копии)moder\_checkФлаг проверки статьи (авто)модератором на качествоmoder\_orphОценка орфографии (1 - без ощибок, 0 - с ошибками)moder\_puncОценка пунктуации и грамматики (1 - без ощибок, 0 - с ошибками)moder\_styleОценка стилистики (1 - без ощибок, 0 - с ошибками)---

**buy** - Функция осуществляет покупку указанной статьи текущим пользователем

```
$client->articles()->buy($id);
```

#### Входные параметры

[](#входные-параметры-30)

ПараметрТипОписаниеidintИдентификатор покупаемой статьи#### Результат

[](#результат-34)

ПараметрОписаниеidИдентификатор купленной статьи---

**getText** - Функция выводит тексты запрошенных купленных статей

```
$client->articles()->getText($id);
```

#### Входные параметры

[](#входные-параметры-31)

ПараметрТипОписаниеidarray (int var1, int var2, ...)Массив идентификаторов купленных статей#### Результат

[](#результат-35)

ПараметрОписаниеidИдентификатор купленной статьиtitleНазвание купленной статьиdescriptionОписание статьиtextТекст купленной статьи---

**download** - Функция создает zip архив с текстами и изображениями указанных купленных статей для текущего пользователя

```
$client->articles()->download($id);
```

#### Входные параметры

[](#входные-параметры-32)

ПараметрТипОписаниеidarray (int var1, int var2, ...)Массив идентификаторов купленных статей#### Результат

[](#результат-36)

ПараметрОписаниеpathПуть для скачивания ZIP архива---

Возвращает список купленных пользователм статей и перенесенных в архив статей
=============================================================================

[](#возвращает-список-купленных-пользователм-статей-и-перенесенных-в-архив-статей)

```
$client->articlesArchive();
```

Доступные методы
----------------

[](#доступные-методы-7)

**getList** - Возвращает список купленных пользователм статей и перенесенных в архив статей.

```
$client->articlesArchive()->getList($config);
```

#### Входные параметры

[](#входные-параметры-33)

ПараметрТипОписаниеcountintЧисло статей для выборке, не более 20 за запрос (по умолчанию)fromintСмещение от последней записи в выборке, по умолчанию 0id\_userintИдентификатор автора статьи для фильтрации спискаid\_subtypeintИдентификатор типа статьи для фильтрации списка (от 1 до 10)orderstringПорядок сортировки, возможные значения: desc, asc (по умолчанию)id\_categoryintИдентификатор категории статьи для фильтрации спискаsubcatintОпция поиска в подкатегориях (1 - искать в подкатегориях, 0 - нет, по умолчанию)textstring (40)Строка для поиска по названию, описанию и ключевым словам#### Результат

[](#результат-37)

ПараметрОписаниеidИдентификатор статьиtitleНазвание статьиdescriptionОписание статьиkeywordsКлючевые слова статьиdateДата добавления статьи, unixtimeid\_typeИдентификатор типа текста статьиid\_subtypeИдентификатор типа статьиid\_categoryИдентификатор категории статьиid\_languageИдентификатор языка текста статьиfull\_priceЦена статьи, включая комиссию для покупателяsizeЧисло символов в статьеimagesЧисло изображений в статьеqualityМассив качественных оценок статьи, если она была проверена (авто) модератором---

**getText** - Функция выводит тексты запрошенных статей из архива текущего пользователя

```
$client->articlesArchive()->getText($id);
```

#### Входные параметры

[](#входные-параметры-34)

ПараметрТипОписаниеidarray (int var1, int var2, ...)Массив идентификаторов статей в архиве#### Результат

[](#результат-38)

ПараметрОписаниеidИдентификатор статьиtitleНазвание статьиdescriptionОписание статьиtextТекст статьи---

**download** - Функция создает zip архив с текстами и изображениями указанных статей из архива для текущего пользователя

```
$client->articlesArchive()->download($id);
```

#### Входные параметры

[](#входные-параметры-35)

ПараметрТипОписаниеidarray (int var1, int var2, ...)Массив идентификаторов статей из архива#### Результат

[](#результат-39)

ПараметрОписаниеpathПуть для скачивания ZIP архива---

Функция возвращает список групп для БС/ЧС текущего пользователя
===============================================================

[](#функция-возвращает-список-групп-для-бсчс-текущего-пользователя)

```
$client->bwgroups();
```

Доступные методы
----------------

[](#доступные-методы-8)

**listGroups** - Функция возвращает список групп для БС/ЧС текущего пользователя.

```
$client->bwgroups()->listGroups();
```

#### Результат

[](#результат-40)

ПараметрОписаниеid\_categoryИдентификатор группыid\_parentИдентификатор родительской группыnameНазвание группыdepthГлубина вложенности группыlastФлаг, является ли группа последней по глубине вложенности---

**saveGroup** - Функция добавляет или изменяет группу для БС/ЧС текущего пользователя.

```
$client->bwgroups()->saveGroup($name, $id, $id_parent);
```

#### Входные параметры

[](#входные-параметры-36)

ПараметрТипОписаниеnamestringНазвание группы, до 40 символовidintИдентификатор редактируемой группы, если не указан, будет создана новаяid\_parentintИдентификатор родительской категории, по умолчанию 0 - корень#### Результат

[](#результат-41)

ПараметрОписаниеidИдентификатор созданной или отредактированной группы---

**deleteGroup** - Функция удаляет группу для БС/ЧС и все ее подгруппы текущего пользователя.

```
$client->bwgroups()->deleteGroup($id);
```

#### Входные параметры

[](#входные-параметры-37)

ПараметрТипОписаниеidintИдентификатор удаляемой группы#### Результат

[](#результат-42)

ПараметрОписаниеidsМассив идентификаторов удаленных групп---

**updateGroup** - Функция перемещает пользователя, уже занесенного в БС/ЧС, в указанную группу текущего пользователя.

```
$client->bwgroups()->updateGroup($id_user, $id_group);
```

#### Входные параметры

[](#входные-параметры-38)

ПараметрТипОписаниеid\_userintИдентификатор пользователя, уже внесенного в БС/ЧС, для переноса в другую группуid\_groupintИдентификатор группы для переноса, если 0 или не указана, то считается как "без группы"#### Результат

[](#результат-43)

ПараметрОписаниеid\_userИдентификатор перенесенного пользователяid\_groupИдентификатор группы, куда перенесен пользовательnameНазвание группы, куда перенесе пользователь, если пустая строка, значит пользователь удален из всех групп---

Функция выводит непрочитанные системные сообщения пользователя
==============================================================

[](#функция-выводит-непрочитанные-системные-сообщения-пользователя)

```
$client->messages();
```

Доступные методы
----------------

[](#доступные-методы-9)

**getList** - Функция выводит непрочитанные системные сообщения пользователя. Максимальный лимит сообщений 100.

```
$client->messages()->getList($from);
```

#### Входные параметры

[](#входные-параметры-39)

ПараметрТипОписаниеfromintДата, с которой выводить сообщения, unixtime#### Результат

[](#результат-44)

ПараметрОписаниеidИдентификатор сообщенияdateДата сообщения, unixtimetextТекст сообщения, может содержать HTML или BB форматирование---

**setRead** - Функция помечает указанные непрочитанные системные сообщения пользователя как прочитанные.

```
$client->messages()->setRead($ids);
```

#### Входные параметры

[](#входные-параметры-40)

ПараметрТипОписаниеidsarray (int var1, int var2, ...)Массив идентификаторов сообщений#### Результат

[](#результат-45)

ПараметрОписаниеidsМассив идентификаторов отмеченных сообщений---

**setDelete** - Функция удаляет указанные непрочитанные системные сообщения пользователя.

```
$client->messages()->setDelete($ids);
```

#### Входные параметры

[](#входные-параметры-41)

ПараметрТипОписаниеidsarray (int var1, int var2, ...)Массив идентификаторов сообщений#### Результат

[](#результат-46)

ПараметрОписаниеidsМассив идентификаторов удаленных сообщений---

**readPrivate** - Функция выводит сообщения из привата с указанным пользователем.

```
$client->messages()->readPrivate($config);
```

#### Входные параметры

[](#входные-параметры-42)

ПараметрТипОписаниеid\_userintИдентификатор пользователя, обязательный параметрcountintЧисло сообщений для выборки, максимально и по умолчанию 100fromintСмещение, начиная с которого выбирать, по умолчанию 0date\_fromintДата начала выборки, unixtimedate\_tointДата окончания выборки, unixtimeunreadintЕсли указано 1, то выводятся только непрочитанные сообщения, показанные сообщения сразу пометятся как прочитанные#### Результат

[](#результат-47)

ПараметрОписаниеdateДата сообщения, unixtimetextТекст сообщенияid\_authorИдентификатор автора сообщенияid\_userИдентификатор собеседникаreadsФлаг прочтения сообщения, 1 - прочитано, 0 - не прочитано---

**getCountUnread** - Функция возвращает количество непрочитанных сообщений из привата, с группировкой по авторам.

```
$client->messages()->getCountUnread();
```

#### Результат

[](#результат-48)

ПараметрОписаниеcountОбщее количество непрочитанных сообщенийusersМассив ассоциативных пар значений \[id\_author => идентификатор пользователя, count => количество непрочитанных сообщений\]---

**writePrivate** - Функция посылает сообщение в приват указанному пользователем. Данная возможность доступна пользователям с рейтингом более 10000. Таймаут между сообщениями 1 минута.

```
$client->messages()->writePrivate($id_user, $text);
```

#### Входные параметры

[](#входные-параметры-43)

ПараметрТипОписаниеid\_userintИдентификатор пользователя, обязательный параметрtextstringТекст сообщения, максимально 10000 символов#### Результат

[](#результат-49)

ПараметрОписаниеid\_userИдентификатор пользователя, которому посылается сообщениеtextТекст сообщенияtimeВремя отсылки, unixtime---

Функция выводит список отказов от заказов для заказчика
=======================================================

[](#функция-выводит-список-отказов-от-заказов-для-заказчика)

```
$client->rating();
```

Доступные методы
----------------

[](#доступные-методы-10)

**listTasksFails** - Функция выводит список отказов от заказов для заказчика.

```
$client->rating()->listTasksFails($id_task, $id_user, $back);
```

#### Входные параметры

[](#входные-параметры-44)

ПараметрТипОписаниеid\_taskintИдентификатор конкретного заказаid\_userintИдентификатор конкретного исполнителяbackintФлаг фильтрации по статусу возврата (1 - с возвратом рейтинга, 2 - без возврата, 0 - все, по умолчанию)#### Результат

[](#результат-50)

ПараметрОписаниеid\_taskИдентификатор заказаid\_userИдентификатор исполнителяdateДата отказа, unixtimedate\_backДата возврата рейтинга, unixtimebackФлаг возврата рейтингаtitleНазвание заказа---

**ratingUserBack** - Функция возвращает рейтинг исполнителю по определенному отказу.

```
$client->rating()->ratingUserBack($id_task, $id_user);
```

#### Входные параметры

[](#входные-параметры-45)

ПараметрТипОписаниеid\_taskintИдентификатор конкретного заказаid\_userintИдентификатор конкретного исполнителя#### Результат

[](#результат-51)

ПараметрОписаниеid\_taskИдентификатор заказаid\_userИдентификатор исполнителяrate\_backКоличество возвращенного рейтинга исполнителю---

Функция показывает степень схожести двух текстов
================================================

[](#функция-показывает-степень-схожести-двух-текстов)

```
$client->diff();
```

Доступные методы
----------------

[](#доступные-методы-11)

**compareText** - Функция показывает степень схожести двух текстов

```
$client->diff()->compareText($source, $text);
```

#### Входные параметры

[](#входные-параметры-46)

ПараметрТипОписаниеsourcestringИсходный текст (длина от 30 до 20000 знаков)textstringТекст для сравнения (длина от 30 до 20000 знаков)#### Результат

[](#результат-52)

ПараметрОписаниеresultПроцент совпаденийtextРезультат сравнения для textsourceРезультат сравнения для source---

Функция создает задание на коррекцию текста
===========================================

[](#функция-создает-задание-на-коррекцию-текста)

```
$client->correction();
```

Доступные методы
----------------

[](#доступные-методы-12)

**add** - Функция создает задание на коррекцию.

```
$client->correction()->add($config);
```

#### Входные параметры

[](#входные-параметры-47)

ПараметрТипОписаниеtitlestringЗаголовок задания, обязательный параметрdescriptionstringОписание заданияtextstringПроверяемый текст, обязательный параметрid\_folderintИдентификатор папки проекта задания, по умолчанию 0deadlinestringДата проверки текста корректором в формате дд.мм.гггг, по умолчанию (минимально возможное) - текущее время плюс 1 суткиtimelinestringCрок проверки текста корректором в формате чч:мм, 23:59 по умолчанию#### Результат

[](#результат-53)

ПараметрОписаниеidИдентификатор добавленного задания---

**import** - Функция создает задание на коррецию из заказов и статей.

```
$client->correction()->import($config);
```

#### Входные параметры

[](#входные-параметры-48)

ПараметрТипОписаниеtypestringТип объекта ('task' - заказ, 'a\_task' - заказ из архива, 'article' - купленная статья, 'a\_article' - купленная статья из архива), обязательное полеid\_objectintИдентификатор объекта, обязательное поле. Внимание, для типа объекта 'task' необходимо указывать идентификатор результата выполнения заказа (а не самого заказа))!object\_typestringПодтип объекта, может принимать единственное значений 'file', что указывает на приоритет импорта вложения, а не текстового поля (например, при импорте из результата заказа, когда сдается вложение и просто текст в поле)).deadlinestringДата проверки текста корректором в формате дд.мм.гггг, по умолчанию (минимально возможное) - текущее время плюс 1 суткиtimelinestringCрок проверки текста корректором в формате чч:мм, 23:59 по умолчанию#### Результат

[](#результат-54)

ПараметрОписаниеidИдентификатор добавленного задания---

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~140 days

Total

2

Last Release

2615d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6193985?v=4)[Александр Касьянов](/maintainers/carono)[@carono](https://github.com/carono)

---

Top Contributors

[![carono](https://avatars.githubusercontent.com/u/6193985?v=4)](https://github.com/carono "carono (9 commits)")

### Embed Badge

![Health badge](/badges/carono-etxtru-api/health.svg)

```
[![Health](https://phpackages.com/badges/carono-etxtru-api/health.svg)](https://phpackages.com/packages/carono-etxtru-api)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)