Доступ через API к базе штрихкодов : База штрихкодов

Описание API ресурса https://barcodes.olegon.ru

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

REST
База штрихкодов поддерживает формат RESTful web-API, возвращая статус ответа и массив объектов в формате JSON. По умолчанию ответы выдаются в JSON unescaped, в кодировке UTF-8.

Коды ответов совпадают с кодами HTTP и в большинстве случаев отдаются, как по протоколам HTTP/HTTPS, так и в ответе JSON.
Основные коды ответов: 200 - запрос успешный, 400 - неправильные параметры запроса, 404 - данные отсутствуют, 429 - запросы без ключа и без подтверждения, что не робот.

Запрос наименования по штрихкоду
Выдает код ответа и массив наименований для штрихкода, обозначенного в <ШТРИХКОД> (<> указывать не надо)
Запрос группы классификатора по штрихкоду
Выдает код ответа и массив групп классификатора для штрихкода, обозначенного в <ШТРИХКОД> (<> указывать не надо)
Ключ для безлимитных запросов
В этом случае ограничения на частоту запросов ближе к ограничениям железа (если требуется более 3 запросов в секунду - прошу предупредить меня об этом, чтобы не сработала защита от DDoS), но за каждый запрос, в случае его успешности, будет сниматься один балл с привязанного к ключу счета. Зарегистрироваться для получения ключа можно здесь. Антибот-код доступа для регистрации - число, которое уже введено в поле кода, увеличенное на три. Т.е., если в поле указано 11, то надо ввести 14. Пополнить счет для безлимитных запросов или просто поддержать ресурс можно здесь. Обратите внимание, что учетки с нулевым балансом в начале каждого месяца удаляются. При перерегистрации в этом случае будет выдан новый ключ!
Вы можете узнать, сколько на ключе осталось средств, выполнив запрос
В ответ будет массив вида Где Х - количество оставшихся попыток на заданном ключе.
В любом случае, если ключ неправильный или попытки исчерпаны - выдается ошибка 402.

Пополнение базы штрихкодов
на тот же адрес (в соответствии с REST), необходимо POST-запросом отправить в параметре card отправить JSON-массив, содержащий name - имя карточки товара, class - группа классификатора карточки, count - единица измерения, producer - производитель товара. Для упрощения приведу пример с curl
Параметры, кроме наименования, необязательные.
Помимо этого, с радостью приму от вас текстовый файл с разделителями, содержащий минимум связку штрихкод-наименование.

Обратите внимание, что игнорирующие 429 код попадают в бан.

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

Пополнять базу можно не только новыми карточками, но и более полными и правильными наименованиями.

По поводу пополнения баланса учетки еще раз подчеркну: учетки с нулевым балансом в начале месяца удаляются. Соответственно, пропадает и ключ. Если у вас давным давно учетка занулилась, то пополнять ее с тем же ключом нет никакого смысла, запросите новый. В противном случае просто сделаете мне подарок.

Теперь есть возможность запросить наименования сразу по нескольким штрихкодам.
Для этого подготовлен отдельный скрипт Ему, в POST-запросе, необходимо передать параметрами:
json (false) - true/false, если true, то возвращаться список будет в формате JSON, в противном случае - CSV с разделителем табуляцией.
barlst - список штрихкодов для сопоставления с наименованиями товара. Каждый штрихкод на новой строке, т.е. c разделителем "\n". Штрихкоды подвергаются trim().
lickey - ключ для безлимитных запросов

Не рекомендуется запрашивать более 100000 штрихкодов за один раз. Теоретически сервер сможет передать и десятикратное количество. Но, я специально ограничил размер POST в 2М, поскольку разная нагрузка, разная скорость интернета, где-то может порваться.

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

Протестировать работу скрипта и посмотреть пример его работы можно здесь : https://olegon.ru/showthread.php?t=34026

Теперь есть возможность поиска по подстроке в наименованиях товаров.
Для этого подготовлен отдельный скрипт
Ему, в POST-запросе, необходимо передать параметрами:
n - подстрока поиска в наименованиях
l - ключ для безлимитных запросов
в ответ будет выдан JSON-файл с массивом найденных товаров и идентификаторов штрихкодов для них.
За каждый запрос будет снята одна попытка с указанного ключа, независимо от количества полученных результатов.
Протестировать работу скрипта и посмотреть пример его работы можно здесь : https://olegon.ru/showthread.php?t=34552

Теперь есть возможность получить штрихкод по его идентификатору в базе штрихкодов.
Для этого подготовлен отдельный скрипт
Ему, в POST-запросе, необходимо передать параметрами:
i - идентификатор штрихкода
l - ключ для безлимитных запросов
в ответ будет выдан штрихкод, соответствующий этому идентификатору, простым текстом.
За каждый запрос будет снята одна попытка с указанного ключа, независимо от результата запроса.