API для работы с TurboText

API позволяет осуществлять работу с TurboText программным способом. Все вопросы, а также пожелания относительно API, направляйте в службу поддержки.

Описание работы с API

URL: https://www.turbotext.ru/api
Формат запроса: POST

Параметры:

api_key - идентификационный ключ. Доступен на этой странице для зарегистрированных пользователей;
action - выполняемое действие.

Формат ответа: json. Параметры ответа:

success (int) - флаг успешно ли завершилась операция;
errors (text) - сообщение об ошибке, в случае если операция завершилась неудачно.

Пример PHP-скрипта для работы с API TurboText

Возможные действия и их описание

Работа с заказами на копирайтинг/рерайтинг/переводы

Действие	Описание	Входные данные	Выходные данные
get_folders	Возвращает все папки пользователя	отсутствуют	folders (array) - массив с папками Каждый элемент массива содержит: id (int) - уникальный идентификатор папки name (text) - имя папки
get_balance	Возвращает количество доступных средств	отсутствуют	balance (float) - количество денег на балансе blocked_money (float) - количество замороженных средств для выполнения заказов и микрозадач
create_folder	Создаёт новую папку	name (text) - имя новой папки	folder_id (int) - уникальный идентификатор созданной папки
get_orders	Возвращает все заказы пользователя в папке folder_id. Если folder_id не указано, возвращает все заказы.	folder_id (text) - уникальный идентификатор папки (необязательный параметр)	orders (array) - массив с заказами Каждый элемент массива содержит: id (int) - уникальный идентификатор (номер) заказа name (text) - название заказа price (float) - стоимость за 1000 знаков status (int) - статус заказа (1 - в поиске исполнителя, 2 – в работе, 3 – ожидает проверки, 4 – на доработке, 5 – одобрен и оплачен)
create_order	Создаёт новый заказ	order_title (text) - название заказа order_type (int) - тип заказа (1 - копирайтинг, 2 - рерайтинг) order_description (text) - задание для копирайтера, описание заказа order_text (text) - статья для рерайта, если вы заказываете рерайтинг order_size_from (int) - минимальное количество знаков, которое должно быть в тексте (от 300 до 98000) order_size_to (int) - максимальное количество знаков, которое должно быть в тексте (от 300 до 99000) folder_id (int) - идентификатор папки, в которую нужно добавить заказ order_unique (text) - значение уникальности текста. Необязательный параметр order_time (int) - количество часов за которое нужно выполнить заказ (от 2 до 180). Необязательный параметр, значение по умолчанию - 24. time_to_check (int) - количество часов на проверку заказа (от 1 до 180). Необязательный параметр, значение по умолчанию - 72. order_price_for_total (int) - Нужна ли стоимость за весь заказ? 1 - да, 0 - стоимость за 1000 символов. Необязательный параметр, значение по умолчанию - 0. order_price (int) - стоимость за 1000 знаков, копирайтинг от 29, рерайтинг от 22, если order_price_for_total равен 1, то необходимо указать стоимость за весь заказ order_who_can_work (int) - кто может выполнить заказ. 0 - любой исполнитель 1 - только исполнитель определённого уровня (нужно указать уровень в поле order_who_can_work_value) 2 - только исполнители из белого списка (нужно указать id списка в поле order_who_can_work_value) 3 - только один определённый исполнитель (нужно указать id исполнителя в поле order_who_can_work_value). Параметр необязательный. Значение по умолчанию - 0. order_who_can_work_value (int) - в случае, если вы ограничили заказ, сделав его доступным определённой группе исполнителей параметром order_who_can_work, в этом параметре необходимо уточнить свой выбор: В случае, если вы хотите сделать заказ доступным только исполнителям определённого уровня, то укажите в этом параметре цифру, соответствующую уровню (1 - новичок, 2 - базовый уровень, 3 - высокий уровень, 4 - профи). В случае, если вы хотите сделать заказ доступным только для определённого белого списка, то укажите id списка в этом поле. В случае, если вы хотите сделать персональный заказ только для одного конкретного исполнителя, то укажите в этом поле его id order_need_anons (int) - Нужен ли вам анонс? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 order_need_corrector (int) - Нужно ли проверить текст корректором? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 order_need_unique (int) - Нужно ли проверить текст на уникальность? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 order_need_image (int) - Нужно ли прикрепить к заказу картинку? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 draft (int) - Сохранить заказ как черновик? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 keywords (text) - ключевые слова (до 5000 символов). Необязательный параметр.	order_id (int) - уникальный идентификатор созданного заказа
create_translate_order	Создаёт новый заказ на перевод	order_title (text) - название заказа order_original_text (text) - статья для перевода lang1 (int) - язык оригинала: 1 - Русский 2 - Английский 3 - Украинский 4 - Французский 5 - Немецкий 6 - Испанский 7 - Итальянский 8 - Китайский lang2 (text) - язык на выходе 1 - Русский 2 - Английский 3 - Украинский 4 - Французский 5 - Немецкий 6 - Испанский 7 - Итальянский 8 - Китайский order_description (text) - задание для переводчика, описание заказа order_size_from (int) - минимальное количество знаков, которое должно быть в тексте (от 300 до 98000) order_size_to (int) - максимальное количество знаков, которое должно быть в тексте (от 300 до 99000) order_time (int) - количество часов за которое нужно выполнить заказ (от 2 до 180). Необязательный параметр, значение по умолчанию - 24. time_to_check (int) - количество часов на проверку заказа (от 1 до 180). Необязательный параметр, значение по умолчанию - 72. order_who_can_work (int) - кто может выполнить заказ. 0 - любой исполнитель 1 - только исполнитель определённого уровня (нужно указать уровень в поле order_who_can_work_value) 2 - только исполнители из белого списка (нужно указать id списка в поле order_who_can_work_value) 3 - только один определённый исполнитель (нужно указать id исполнителя в поле order_who_can_work_value). Параметр необязательный. Значение по умолчанию - 0. order_who_can_work_value (int) - в случае, если вы ограничили заказ, сделав его доступным определённой группе исполнителей параметром order_who_can_work, в этом параметре необходимо уточнить свой выбор: В случае, если вы хотите сделать заказ доступным только исполнителям определённого уровня, то укажите в этом параметре цифру, соответствующую уровню (1 - новичок, 2 - базовый уровень, 3 - высокий уровень, 4 - профи). В случае, если вы хотите сделать заказ доступным только для определённого белого списка, то укажите id списка в этом поле. В случае, если вы хотите сделать персональный заказ только для одного конкретного исполнителя, то укажите в этом поле его id order_price_for_total (int) - Нужна ли стоимость за весь заказ? 1 - да, 0 - стоимость за 1000 символов. Необязательный параметр, значение по умолчанию - 0. order_price (int) - стоимость за 1000 знаков от 49, если order_price_for_total равен 1, то необходимо указать стоимость за весь заказ folder_id (int) - идентификатор папки, в которую нужно добавить заказ order_need_anons (int) - Нужен ли вам анонс? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 order_need_unique (int) - Нужно ли проверить текст на уникальность? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 order_need_image (int) - Нужно ли прикрепить к заказу картинку? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 draft (int) - Сохранить заказ как черновик? 1 - да, 0 - нет. Необязательный параметр, значение по умолчанию - 0 order_unique (text) - значение уникальности текста. Необязательный параметр	order_id (int) - уникальный идентификатор созданного заказа
get_order	Получает информацию о заказе order_id	order_id (int) - уникальный идентификатор (номер) заказа.	name (text) - название заказа price (float) - стоимость за 1000 знаков status (int) - статус заказа (1 - в поиске исполнителя, 2 – в работе, 3 – ожидает проверки, 4 – на доработке, 5 – одобрен и оплачен) worker_id (int) - уникальный идентификатор исполнителя, работающего над заказом. Если равно 0, значит над заказом никто не работает. description (text) - задание для копирайтера, описание заказа original_text (text) - оригинальный текст date_add (datetime) - дата публикации заказа date_upd (datetime) - дата последнего обновления заказа type (int) - тип заказа (1 - копирайтинг, 2 - рерайтинг) min_ch (int) - минимальное необходимое количество символов max_ch (int) - максимальное необходимое количество символов title (text) - заголовок статьи anons (text) - анонс text (text) - текст статьи symbol_count (int) - количество символов в тексте статьи tags (text) - теги category (text) - категория, выбранная копирайтером image (text) - картинка, прикреплённая к заказу unique (float) - значение уникальности текста (если была заказана проверка) order_time (int) - количество часов на выполнение заказа
delete_order	Удаляет заказ order_id	order_id (int) - уникальный идентификатор (номер) заказа.	Отсутствуют
reject_order	Отправить заказ на доработку	order_id (int) - уникальный идентификатор (номер) заказа text (text) - причина, по которой вы отправляете заказ на доработку	Отсутствуют
decline_order	Отклонить заказ	order_id (int) - уникальный идентификатор (номер) заказа text (text) - причина, по которой вы отказываетесь от заказа	Отсутствуют
accept_order	Принять заказ	order_id * (int) - уникальный идентификатор (номер) заказа text * (text) - комментарий (необязательно) rating (int) - оценка для заказа: 5 - Отлично 4 - Неплохо 3 - Средненько 2 - Плохо 1 - Никуда не годится Параметр необязательный. Значение по умолчанию - 0.	Отсутствуют
move_order	Переместить заказ в определённую папку	order_id (int) - уникальный идентификатор (номер) заказа folder_id (int) - уникальный идентификатор папки, в которую нужно переместить заказ.	Отсутствуют
getConversation	Просмотереть общение по заказу	order_id (int) - уникальный идентификатор (номер) заказа	messages_array (array) - массив, содержащий список сообщений. Каждый элемент массива содержит: from_id (int) - ID пользователя от кого сообщение date (date) - дата отправки text (text) - текст сообщения
unassign_author	Открепить заказ от просрочившего исполнителя	order_id * (int) - уникальный идентификатор (номер) заказа Внимание! После этого заказ станет доступен всем исполнителям. Вы можете поменять цену и доступ с помощью edit_order или удалить заказ delete_order.	Отсутствуют
extend_time_order	Продлить время заказа	order_id * (int) - уникальный идентификатор (номер) заказа order_hours * (int) - сколько часов добавить (от 1 до 96 включительно)	Отсутствуют
edit_order	Редактировать заказ	order_id * (int) - уникальный идентификатор (номер) заказа order_price_for_total (int) - Нужна ли стоимость за весь заказ? 1 - да, 0 - стоимость за 1000 символов. Необязательный параметр, значение по умолчанию - 0. order_price (int) - стоимость за 1000 знаков, копирайтинг от 29, рерайтинг от 22, если order_price_for_total равен 1, то необходимо указать стоимость за весь заказ order_unique (text) - требования к уникальности order_who_can_work (int) - кто может выполнить заказ. 0 - любой исполнитель 1 - только исполнитель определённого уровня (нужно указать уровень в поле order_who_can_work_value) 2 - только исполнители из белого списка (нужно указать id списка в поле order_who_can_work_value) 3 - только один определённый исполнитель (нужно указать id исполнителя в поле order_who_can_work_value). order_who_can_work_value (int) - в случае, если вы ограничили заказ, сделав его доступным определённой группе исполнителей параметром order_who_can_work, в этом параметре необходимо уточнить свой выбор: В случае, если вы хотите сделать заказ доступным только исполнителям определённого уровня, то укажите в этом параметре цифру, соответствующую уровню 1 - новичок 2 - базовый уровен 3 - высокий уровень 4 - профи В случае, если вы хотите сделать заказ доступным только для определённого белого списка, то укажите id списка в этом поле. В случае, если вы хотите сделать персональный заказ только для одного конкретного исполнителя, то укажите в этом поле его id	Отсутствуют

Работа со списками исполнителей

Действие	Описание	Входные данные	Выходные данные
get_user	Возвращает информацию о пользователе	user_id (int) - уникальный идентификатор пользователя	user_name (text) - ник пользователя user_rating (int) - рейтинг пользователя в системе user_type (int) - тип пользователя (1 - исполнитель, 2 - заказчик, 3 - корректор)
get_lists	Возвращает все белые списки пользователя	Отсутствуют	lists (array) - массив со списками Каждый элемент массива содержит: id (int) - уникальный идентификатор списка name (text) - имя списка
get_list	Возвращает всех исполнителей, которые присутствуют в определённом белом списке	list_id (int) - уникальный идентификатор списка	users (array) - массив с исполнителями Каждый элемент массива содержит: user_id (int) - уникальный идентификатор пользователя name (string) - ник пользователя
add_to_list	Добавляет пользователя в список	list_id (int) - уникальный идентификатор списка, в который нужно добавить пользователя user_id (int) - уникальный идентификатор пользователя	Отсутствуют
remove_from_list	Удаляет пользователя из списка	list_id (int) - уникальный идентификатор списка, из которого нужно удалить пользователя user_id (int) - уникальный идентификатор пользователя	Отсутствуют
add_to_black_list	Добавляет пользователя в черный список	user_id (int) - уникальный идентификатор пользователя	Отсутствуют
remove_from_black_list	Удаляет пользователя из черного списка	user_id (int) - уникальный идентификатор пользователя	Отсутствуют

Работа с микрозадачами

Действие	Описание	Входные данные	Выходные данные
get_microtasks_folders	Возвращает все папки для микрозадач	отсутствуют	folders (array) - массив с папками Каждый элемент массива содержит: id (int) - уникальный идентификатор папки name (text) - имя папки
create_microtasks_folder	Создаёт новую папку для микрозадач	name (text) - имя новой папки	folder_id (int) - уникальный идентификатор созданной папки
get_microtasks_orders	Возвращает все микрозадачи в папке folder_id. Если folder_id не указано, возвращает все микрозадачи.	folder_id (int) - уникальный идентификатор папки (необязательный параметр)	orders (array) - массив с микрозадачами Каждый элемент массива содержит: id (int) - уникальный идентификатор (номер) задачи name (text) - название задачи price (float) - стоимость за выполнение задачи active (int) - статус задание (1 - активно, 0 – выключено)
create_microtask	Создаёт новую микрозадачу	microtask_title (text) - название микрозадачи microtask_descr (text) - подробное описание задания microtask_price (int) - стоимость задания в рублях (целое число больше или равное 2) microtask_folder_id (int) - идентификатор папки, в которую нужно добавить микрозадачу microtask_time (int) - количество часов за которое нужно выполнить микрозадачу (от 1 до 240). Необязательный параметр, значение по умолчанию - 12. limit_per_user (int) - лимит для одного исполнителя (сколько заданий может выполнить 1 исполнитель). 0 - без ограничений. Необязательный параметр, значение по умолчанию - 0. limit_per_day (int) - лимит в сутки. 0 - без ограничений. Необязательный параметр, значение по умолчанию - 0. limit_total (int) - лимит на общее количество выполнений задания. 0 - без ограничений. Необязательный параметр, значение по умолчанию - 0. who_can_work (int) - кто может выполнить заказ. 0 - любой исполнитель, 2 - только исполнители из белого списка (нужно указать id списка в поле who_can_work_value), 3 - только один определённый исполнитель (нужно указать id исполнителя в поле order_who_can_work_value). Параметр необязательный. Значение по умолчанию - 0. who_can_work_value (int) - в случае, если вы ограничили заказ, сделав его доступным определённой группе исполнителей параметром who_can_work, в этом параметре необходимо уточнить свой выбор: В случае, если вы хотите сделать заказ доступным только для определённого белого списка, то укажите id списка в этом поле. В случае, если вы хотите сделать персональный заказ только для одного конкретного исполнителя, то укажите в этом поле его id	microtask_id (int) - уникальный идентификатор созданной микрозадачи
get_microtasks_tasks	Возвращает все отчёты о выполненных заданиях, ожидающие проверки, для микрозадачи microtask_id. Если microtask_id не указано, возвращает все отчёты, ожидающие проверки.	microtask_id (int) - уникальный идентификатор микрозадачи (необязательный параметр)	tasks (array) - массив с отчётами Каждый элемент массива содержит: id (int) - уникальный идентификатор (номер) отчёта user_id (int) - уникальный идентификатор исполнителя price (int) - стоимость за выполнение задачи text (text) - текст отчёта
microtasks_reject_task	Отправить задание на доработку или отказаться от него	task_id (int) - уникальный идентификатор (номер) отчёта по задаче text (text) - причина, по которой вы отправляете задачу на доработку или отклоняете decline (int) - в случае, если параметр decline равен 1, то задание будет отклонено без возможности доработки. Необязательный параметр, значение по умолчанию - 0.	Отсутствуют
microtasks_accept_task	Принять и оплатить задачу	task_id (int) - уникальный идентификатор (номер) отчёта по задаче	Отсутствуют
microtasks_pause	Временно остановить выполнение микрозадачи	task_id (int) - уникальный идентификатор (номер) микрозадачи	Отсутствуют
microtasks_play	Включить выполнение ранее остановленной микрозадачи	task_id (int) - уникальный идентификатор (номер) отчёта по задаче	Отсутствуют

Работа с личными сообщениями

Действие	Описание	Входные данные	Выходные данные
pm_get_sent	Получить список пользователей, кому вы отправляли личные сообщения	Отсутствуют	users_array (array) - массив, содержащий ID пользователей
pm_get_received	Получить список пользователей, которые вам отправляли личные сообщения	Отсутствуют	users_array (array) - массив, содержащий ID пользователей
pm_send	Отправить личное сообщение	user_id (int) - ID пользователя, которому нужно отправить сообщение message (text) - текст сообщения	Отсутствуют
pm_get_conversation	Получить переписку с определённым пользователем	user_id (int) - ID пользователя, переписку с которым нужно получить	messages_array (array) - массив, содержащий список сообщений. Каждый элемент массива содержит: from_id (int) - ID пользователя от кого сообщение to_id (int) - ID пользователя кому сообщение date (date) - дата отправки unread (bool) - флаг прочитано сообщение или нет text (text) - текст сообщения