Dokumentacja API

Twórz kody QR i kody kreskowe z produktu przez REST API. Wyślij JSON na /api/v1, odbierz hostowaną grafikę SVG, a następnie listuj lub aktualizuj te same zasoby.

Utwórz kod QR

POST /api/v1/qr-codes z type, treścią i opcjonalnym projektem: kolory, styl modułów, logo, oczy i ramka. Odpowiedź zawiera hostowany URL SVG.

{
  "name": "Website QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "rounded",
  "size": 500,
  "ecc": "M",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "qr_code_logo": "https://forqrcode.com/logo.png",
  "qr_code_logo_size": 25
}
Dokumentacja tworzenia QR

Utwórz kod kreskowy

POST /api/v1/barcodes z symbologią, value oraz opcjonalnymi kolorami lub rozmiarem. Dostępne są trzydzieści cztery typy, od Code 128 do EAN-13.

{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}
Dokumentacja tworzenia kodu kreskowego

Uwierzytelnianie

Wysyłaj klucz API jako token Bearer w każdym żądaniu. Znajdziesz go lub wygenerujesz ponownie w Panel → Konto → API.

Authorization: Bearer YOUR_API_KEY

Bazowy URL: https://forqrcode.com/api/v1

Limity częstotliwości

Każdy klucz API ma limit 60 żądań na minutę. Odpowiedzi zawierają nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset.

Błędy

Błędy używają formatu JSON:API:

{ "errors": [{ "title": "…", "status": "422" }] }

Błędy walidacji mogą zawierać source.pointer.