Pixodrom API

Описание программного интерфейса сервиса обработки изображений

Загрузка изображений через веб-форму

URL: http://pixodrom.com/imacros.html

Загрузка изображения на обработку сервисом (POST-методом)

URL: http://pixodrom.com/in
Альтернативные URL: http://pixodrom.com/in.php
HTTP-метод: POST
multi-from-data: ДА

Обязательные параметры:

Название Значения и описание
methodвсегда равно POST
keyВаш секретный ключ
fileТело файла со всеми параметрами в виде "multipart/form-data"

Необязательные параметры:

НазваниеЗначения и описание
is_russianНа изображении присутствуют русские символы
calcНадо ли выполнить математическое преобразование
min_lenМинимальная длина слова
max_lenМаксимальная длина слова
numeric
phraseЕсли на изображении больше одного слова, то 1, иначе 0
regsenseЧувствительность к регистру вводимого слова
soft_idКлюч приложения

Ответ сервера:

OK|номер_задачи - капча принята на распознавание и ей присвоен номер
ERROR_описание_ошибки - при приёме задачи возникла ошибка

Загрузка изображения в формате BASE64 (разрешён GET-запрос)

URL: http://pixodrom.com/in
Альтернативные URL: http://pixodrom.com/in.php
HTTP-метод: GET или POST

Обязательные параметры:

Название Значения и описание
methodвсегда равно "base64"
keyВаш секретный ключ
bodyТело файла в формате base64"

Необязательные параметры:

НазваниеЗначения и описание
is_russian1-На изображении присутствуют русские символы (например, для ВКонтакте); 0-в противном случае
calcНадо ли выполнить математическое действие
min_lenМинимальная длина слова от 0 до 16
max_lenМаксимальная длина слова от 0 до 16
numeric1-капча состоит из цифр; 2-в капче нет цифр; 0-не учитывается
phraseЕсли на изображении больше одного слова, то 1, иначе 0 (используется для решения reCAPTCHA)
regsenseЧувствительность к регистру вводимого слова
header_acao0-не использовать; 1-передавать в заголовках ответа (in.php/res.php) значение Access-Control-Allow-Origin: * (используется в браузерных приложениях для AJAX-запросов)
labelМетка кпвчи: "vk", "google", "recaptcha", "yandex", "mailru", "yahoo" и т.д. (необязательный парамер)
soft_idКлюч приложения, который Вы можете получить здесь и получать 10% дохода от всех капч

Ответ сервера:

OK|номер_задачи - капча принята на распознавание и ей присвоен номер
ERROR_описание_ошибки - при приёме задачи возникла ошибка
ERROR_ZERO_BALANCE - недостаточно средств на счету. Необходимо пополнить баланс. Сделать это можно на странице http://pixodrom.com/finances/addfunds
ERROR_WRONG_FILE_EXTENSION - недопустимый формат изображения. Разрешены форматы: GIF, PNG, JPG, JPEG
ERROR_TOO_BIG_CAPTCHA_FILESIZE - слишком большой размер изображения

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

URL: http://pixodrom.com/res
Альтернативные URL: http://pixodrom.com/res.php
HTTP-метод: GET

Передаваемый GET-параметр Значения и описание
keyВаш секретный ключ
actiongetbalance

Пример:
http://pixodrom.com/res.php?key=YOUR_SECRET_KEY_HERE&action=getbalance

Получение результата распознавания

URL: http://pixodrom.com/res
Альтернативные URL: http://pixodrom.com/res.php
HTTP-метод: POST/GET

Передаваемый GET-параметр Значения и описание
keyВаш секретный ключ
actionget
idномер изображения

Ответ сервера:

OK|распознанный_ответ - текст на изображении распознан успешно
CAPCHA_NOT_READY - ответ ещё не готов, в процессе распознавания
ERROR_CAPTCHA_UNSOLVABLE - невозможно распознать текст на изображении
ERROR_описание_ошибки - при приёме задачи возникла ошибка

Получение результатов распознавания нескольких капч

URL: http://pixodrom.com/res
Альтернативные URL: http://pixodrom.com/res.php
HTTP-метод: POST/GET

Передаваемый GET-параметр Значения и описание
keyВаш секретный ключ
actionget
idsномера изображений, разделённых запятой

Пример:
http://pixodrom.com/res.php?key=YOUR_SECRET_KEY_HERE&action=get&ids=ID_1,ID_2,...,ID_N

Ответ сервера:

Результаты по каждой капче будут разделены знаком "|", например:
жфхд|CAPCHA_NOT_READY|CAPCHA_NOT_READY|xz75d

Распознавание иероглифов

URL: http://pixodrom.com/chinese/
HTTP-метод: POST/GET

Передаваемый параметр Значения и описание
key Ваш секретный ключ
p список координат в формате:

R:количество_областей|<список_областей>
список_областей = S:количество_точек|<координаты_точек>
координаты_точек = X1,Y1,X2,Y2,...Xn,Yn координаты - целочисленные значения в диапазоне 0..128

Ответ сервера:

OK|список_иероглифов_разделённых_точкой_с_запятой
Например:
OK|大,dà,dài;丈,zhàng;夫,fū;尢,yóu,wāng;井,jǐng;廾,gǒng;太,tài;卅,sà;女,nǚ;开,kāi;九,jiǔ;夬,guài;友,yǒu;卄,niàn;艹,cǎo;艾,ài;达,dá;干,gān,gàn;;丹,dān;廿,niàn;亾,wáng,wú;凡,fán;仗,zhàng;;毌,guàn;片,piān,piàn;什,shén,shí;卆,zú,cù;子,zǐ;中,zhōng,zhòng;区,qū;月,yuè;仐,tāo;亼,jí;兦,wáng,wú;込,rù;辷,yī;户,hù;闩,shuān;心,xīn;