API для генерации штрих-кодов

Бесплатный API без ключа: передайте параметры в URL и получите изображение штрих-кода SVG или PNG.

Быстрый старт

Вставьте URL API в атрибут src изображения:

HTML
<img src="https://qr-code-generator.online/api/v1/barcode?type=ean13&data=5901234123457&format=svg" alt="Штрих-код">

Запрос

HTTP
GET /api/v1/barcode

Все параметры передаются в строке запроса. Схема OpenAPI описывает параметры и ответы.

Параметры

ПараметрЗначение
typeean13, ean8, upca, upce, code128, gs1-128, code39, code93, itf14, interleaved2of5, msi, pharmacode, codabar, datamatrix, gs1datamatrix, pdf417, azteccode. По умолчанию code128.
dataОбязательные данные: от 1 до 512 символов.
formatsvg или png. По умолчанию svg.
scaleЦелый масштаб от 1 до 10. По умолчанию 3.
heightЦелая высота линейного кода от 1 до 200 мм, по умолчанию 15. Для двумерных кодов определяется данными.
includetexttrue или false — показывать текст под штрих-кодом
colorЦвет линий в HEX без #
bgЦвет фона в HEX без #
rotateN, R, L или I
type

ean13, ean8, upca, upce, code128, gs1-128, code39, code93, itf14, interleaved2of5, msi, pharmacode, codabar, datamatrix, gs1datamatrix, pdf417, azteccode. По умолчанию code128.

data

Обязательные данные: от 1 до 512 символов.

format

svg или png. По умолчанию svg.

scale

Целый масштаб от 1 до 10. По умолчанию 3.

height

Целая высота линейного кода от 1 до 200 мм, по умолчанию 15. Для двумерных кодов определяется данными.

includetext

true или false — показывать текст под штрих-кодом

color

Цвет линий в HEX без #

bg

Цвет фона в HEX без #

rotate

N, R, L или I

Ответ и ошибки

  • 200 — изображение image/svg+xml или image/png.
  • 400 — JSON {"error":"…"} с описанием ошибки.
  • 429 — превышен лимит запросов.

Лимиты

Предварительно: 60 запросов в минуту и 5 000 запросов в сутки с одного IP-адреса. При ответе 429 заголовок Retry-After указывает время ожидания в секундах.

Длина данных — до 512 символов. Ширина и высота изображения — до 4096 px. Готовые изображения кешируются на год. CORS разрешает запросы с любого сайта.

Примеры

curl
curl "https://qr-code-generator.online/api/v1/barcode?type=code128&data=ORDER-123&format=svg"
JavaScript
const response = await fetch("https://qr-code-generator.online/api/v1/barcode?type=code128&data=ORDER-123&format=svg");
const image = await response.blob();
Python
import requests
response = requests.get("https://qr-code-generator.online/api/v1/barcode", params={"type": "code128", "data": "ORDER-123", "format": "svg"})
open("barcode.svg", "wb").write(response.content)
PHP
<?php
$url = "https://qr-code-generator.online/api/v1/barcode?type=code128&data=ORDER-123&format=svg";
file_put_contents("barcode.svg", file_get_contents($url));

Часто задаваемые вопросы

Нужен ли API-ключ?

Нет. Для запроса изображения API-ключ не нужен.

Какие форматы изображений доступны?

API возвращает SVG или PNG. Формат задаётся параметром format.

Можно ли использовать API бесплатно?

Да, в пределах действующих лимитов запросов.

Как передать цвет?

Передайте HEX-значение без символа # в параметрах color и bg.

Что возвращается при ошибке?

При некорректном запросе API отвечает статусом 400 и JSON с полем error.

Попробовать

Настройки штрих-кода

Популярные форматы:

Предпросмотр штрих-кода
Штрих-код Code 128
Ссылка API
https://qr-code-generator.online/api/v1/barcode?type=code128&data=123456789012&format=svg&scale=2&height=10&includetext=true&color=000000&bg=FFFFFF&rotate=N