API

Для осуществления действий на сервисе cFUD вы можете использовать API функции. Чтобы отправлять API запросы на сервер cFUD вам необходимо сгенерировать apikey, авторизовавшись в своем личном кабинете.

Все запросы принимаются на следующий url:
https://cfud.biz/api/

При выполнении каждого запроса необходимо указывать два обязательных GET параметра apikey и command:
https://cfud.biz/api/?apikey=YOUR_KEY&command=COMMAND

Где apikey это ключ, сгенерированный в вашем личном кабинете, а command одна из команд, поддерживающихся API. Это обязательные параметры для любого запроса, все остальные параметры ожидаются как POST.

На любой API запрос будет выдан ответ в формате JSON, который будет содержать массив в едином формате. Каждый ответ будет содержать элемент с индексом response в котором будет общая информация о состоянии ответа, удачное выполнение или ошибка.

Например, если не передавать apikey, то будет сгенерирована соответствующая ошибка и будет выдан следующий ответ:

{
    "response": {
       "status": 0,
       "message": "apikey not found"
    }
}

Где status означает успешное (1) или не успешное (0) выполнение команды, а message содержит текстовую расшифровку состояния выполнения. При успешном выполнении команды (когда “status”:1), если она подразумевает возвращение каких-либо данных, будет добавляться индекс data, который будет содержать данные, возвращенные в результате выполнения команды.


Список команд:


Команды для заказчика на одиночных заданиях
  • cNewTask – создание нового задания
  • cTaskInfo – получение информации о задании
  • cAcceptOffer – принять предложение от исполнителя
  • cTasks – список заданий, созданных клиентом
  • cCancelTask – отмена задания
  • cCloseTask – закрытие задания в пользу исполнителя, выставляя оценку
  • cReturnsToWork – возвращение задания в работу
  • cComplain – перевод задания на рассмотрение администраторам
  • cDownload – скачать файл
Команды для исполнителя на одиночных заданиях
  • pOpenTasks – список заданий, доступных для выполнения
  • pWorkTasks – список рабочих заданий
  • pSendOffer – отправка предложения на задание
  • pTaskInfo – получение информации о рабочем задании
  • pLoadFile – загрузка готового файла на задание
  • pDownload – скачать файл
Команды для исполнителя на безлимитных заданиях
  • pUtaskInfo – Подробная информация о задании
  • pLoadPoolFile – Загрузка файла в пул
Финансовые команды
  • getCurrency – Получить текущий курс валют


cNewTask
https://cfud.biz/api/?apikey=YOUR_KEY&command=cNewTask

Команда создает новое задание с указанными параметрами и файлом. Для выполнения команды, необходимо отправить POST (multipart/form-data) запрос на указанный url.

Принимаемые POST параметры:

file_type
Обязательный параметр, тип файла, может быть exe, dll, apk, js или php. От типа файла зависит стоимость задания.

overlay

Необязательный параметр, указывающий о необходимости учета overlay при крипте, при отсутствии этого параметра, overlay учитываться не будет.

task_file

Обязательный параметр, файл, который необходимо закриптовать.

В ответе, при успешном выполнении, помимо статуса и сообщения, будет передан tid (ID только что созданного задания) в секции data, например:

{
    "response":{…}
    "data":{
       "tid":1
    }
}


cTaskInfo
https://cfud.biz/api/?apikey=YOUR_KEY&command=cTaskInfo

Команда возвращает полную информацию о задании.

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания, информацию о котором нужно получить.

В ответе, при успешном выполнении, помимо статуса и сообщения, будет передана полная информация о задании. Если задание находится на стадии поиска кандидатов, то так же будет указан массив (offers) с предложениями от исполнителей. Помимо этого, команда так же возвращает список файлов (performer_files), загруженных исполнителем, если таковые имеются.


cAcceptOffer
https://cfud.biz/api/?apikey=YOUR_KEY&command=cAcceptOffer

Используя эту команду заказчик может принять исполнителя на задание.

Принимаемые POST параметры:

oid
Обязательный параметр, ID предложения, которое необходимо принять. Данный ID можно получить используя команду cTaskInfo, которая возвращает информацию о задании, в том числе и список предложений.

В ответе, только статус и сообщение.


cTasks
https://cfud.biz/api/?apikey=YOUR_KEY&command=cTasks

Команда возвращает список заданий, которые создал владелец apikey

Принимаемые POST параметры:

Не принимает параметры.

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


cCancelTask
https://cfud.biz/api/?apikey=YOUR_KEY&command=cCancelTask

Команда отменяет задание, если оно на стадии поиска кандидатов

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания, которое необходимо отменить.

В ответе, только статус и сообщение.


cCloseTask
https://cfud.biz/api/?apikey=YOUR_KEY&command=cCloseTask

Команда закрывает задание в пользу исполнителя с выставлением оценки.

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания, которое необходимо закрыть.

grade
Обязательный параметр, оценка за задание, число от -5 до 5.

В ответе, только статус и сообщение.


cReturnsToWork
https://cfud.biz/api/?apikey=YOUR_KEY&command=cReturnsToWork

Команда возвращает задание в работу.

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания, которое необходимо вернуть в работу.

В ответе, только статус и сообщение.


cComplain
https://cfud.biz/api/?apikey=YOUR_KEY&command=cComplain

Команда отправляет задание на рассмотрении администрацией сервиса.

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания, которое необходимо отправить администрации.

В ответе, только статус и сообщение.


cDownload
https://cfud.biz/api/?apikey=YOUR_KEY&command=cDownload

Команда возвращает, запрошенный файл.

Принимаемые POST параметры:

fid
Обязательный параметр, ID файла, который необходимо скачать, данный ID может быть получен при запросе полной информацией о задании, при котором передается массив с файлами, загруженными исполнителем, каждый файл имеет уникальный ID.

В ответе, при успешном выполнении, помимо статуса и сообщения, будет передан массив file в секции data, который будет содержать два элемента data (содержимое файла закодированное в base64) и name (имя файла с расширением), например:

{
    "response":{…}
    "data":{
       "file":{
           "data":"…",
           "name":"program.exe"
       }
    }
}
                


pOpenTasks
https://cfud.biz/api/?apikey=YOUR_KEY&command=pOpenTasks

Команда возвращает список заданий, доступных для выполнения владельцу apikey

Принимаемые POST параметры:

Не принимает параметры.

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


pWorkTasks
https://cfud.biz/api/?apikey=YOUR_KEY&command=pWorkTasks

Команда возвращает список рабочих заданий для владельца apikey

Принимаемые POST параметры:

Не принимает параметры.

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


pSendOffer
https://cfud.biz/api/?apikey=YOUR_KEY&command=pSendOffer

Отправка предложения на задание.

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания, на которое отправляется предложение.

В ответе, только статус и сообщение.


pTaskInfo
https://cfud.biz/api/?apikey=YOUR_KEY&command=pTaskInfo

Команда возвращает полную информацию о задании. Аналогична команде cTaskInfo.


pLoadFile
https://cfud.biz/api/?apikey=YOUR_KEY&command=pLoadFile

Команда позволяет загрузить закриптованный файл для задания. Для выполнения команды, необходимо отправить POST (multipart/form-data) запрос на указанный url.

Принимаемые POST параметры:

tid
Обязательный параметр, ID задания.

file
Обязательный параметр, файл.

В ответе, только статус и сообщение.


pDownload
https://cfud.biz/api/?apikey=YOUR_KEY&command=pDownload

Команда возвращает запрошенный файл. Аналогична команде cDownload.


pUtaskInfo
https://cfud.biz/api/?apikey=YOUR_KEY&command=pUtaskInfo

Команда возвращает подробную информацию о безлимитном задании

Принимаемые POST параметры:

tid
Обязательный параметр, ID безлимитного задания, информацию о котором нужно получить

В ответе, при успешном выполнении, помимо статуса и сообщения, будет передана полная информация о задании. Команда так же возвращает список файлов в пуле и информацию о последнем файле на выдаче.


pLoadPoolFile
https://cfud.biz/api/?apikey=YOUR_KEY&command=pLoadPoolFile

Команда позволяет загрузить закриптованный файл в пул для безлимитного задания. Для выполнения команды, необходимо отправить POST (multipart/form-data) запрос на указанный url.

Принимаемые POST параметры:

tid
Обязательный параметр, ID безлимитного задания

file
Обязательный параметр закриптованный файл

В ответе, только статус и сообщение


getCurrency
https://cfud.biz/api/?command=getCurrency&direction=DIRECTION

Команда возвращает текущий курс по выбранному направлению.

Принимаемые параметры:

direction
Обязательный параметр, валютное направление, может быть одним из следующего списка:

  • usd_rub
  • usd_eur
  • btc_usd
  • btc_rub
  • btc_eur

В ответе, статус и сообщение, а так же поле amount, которое содержит значение текущего курса.