الباركود

أنشئ باركود عبر 34 رمزية، مع خيارات اللون والحجم والتسمية.

الأنواع المدعومة

مرّر type كأحد مفاتيح الرمزية هذه. يجب أن يطابق value قواعد ذلك النوع.

C32
C39
C39+
C39E
C39E+
C93
S25
S25+
I25
I25+
ITF14
C128
C128A
C128B
C128C
EAN2
EAN5
EAN8
EAN13
UPCA
UPCE
MSI
MSI+
POSTNET
PLANET
TELEPENALPHA
TELEPENNUMERIC
RMS4CC
KIX
IMB
CODABAR
CODE11
PHARMA
PHARMA2T

POST/api/v1/barcodes

إنشاء باركود

أرسل JSON يتضمن name و type و value. type هو مفتاح رمزية مثل C128 أو EAN13. الألوان و width_scale و height و display_text تتحكم في الصورة الناتجة.

الاسم	النوع	مطلوب	الافتراضي	الوصف
name	string	نعم	—	التسمية المحفوظة على المورد.
type	string	نعم	C128	مفتاح رمزية مثل C128 أو EAN13 أو UPCA.
value	string	نعم	—	البيانات المشفّرة في الباركود. يجب أن تكون صالحة للنوع المختار.
project_id	integer	لا	—	المشروع لإرفاق المورد به.
is_bulk	boolean	لا	false	إذا كان true، يُنشأ باركود واحد لكل سطر في value.
foreground_color	string	لا	#000000	لون الوحدات بصيغة HEX.
background_color	string	لا	#ffffff	لون الخلفية بصيغة HEX. اجعله أفتح من الوحدات.
width_scale	integer	لا	2	مضاعف عرض الأعمدة، 1–10.
height	integer	لا	30	ارتفاع الأعمدة بالبكسل، 30–1000.
display_text	boolean	لا	false	إذا كان true، تُطبع value تحت الأعمدة.

مثال على الطلب

curl -X POST 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}'

المزيد من الأمثلة

EAN-13

curl -X POST 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Retail EAN-13",
  "type": "EAN13",
  "value": "5901234123457",
  "height": 70,
  "display_text": true
}'

مثال على الاستجابة

{
  "data": {
    "id": 1,
    "type": "C128",
    "name": "Product SKU",
    "value": "FORQR-1001",
    "barcode": "https://…/barcodes/…/barcode.svg"
  }
}

GET/api/v1/barcodes

إدراج باركود

الاسم	النوع	مطلوب	الوصف
page	integer	لا	Page number (default 1)
results_per_page	integer	لا	Items per page (default 25, max 100)
search	string	لا	Search term
search_by	string	لا	Column to search
order_by	string	لا	Sort column
order_type	string	لا	asc or desc
datetime_start	string	لا	ISO datetime filter start
datetime_end	string	لا	ISO datetime filter end

curl -X GET 'https://forqrcode.com/api/v1/barcodes' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET/api/v1/barcodes/{id}

قراءة باركود واحد

الاسم	النوع	مطلوب	الوصف
id	integer	نعم	—

curl -X GET 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

PATCH/api/v1/barcodes/{id}

تحديث باركود

الاسم	النوع	مطلوب	الافتراضي	الوصف
id	integer	نعم	—	—
name	string	لا	—	التسمية المحفوظة على المورد.
type	string	لا	C128	مفتاح رمزية مثل C128 أو EAN13 أو UPCA.
value	string	لا	—	البيانات المشفّرة في الباركود. يجب أن تكون صالحة للنوع المختار.
project_id	integer	لا	—	المشروع لإرفاق المورد به.
is_bulk	boolean	لا	false	إذا كان true، يُنشأ باركود واحد لكل سطر في value.
foreground_color	string	لا	#000000	لون الوحدات بصيغة HEX.
background_color	string	لا	#ffffff	لون الخلفية بصيغة HEX. اجعله أفتح من الوحدات.
width_scale	integer	لا	2	مضاعف عرض الأعمدة، 1–10.
height	integer	لا	30	ارتفاع الأعمدة بالبكسل، 30–1000.
display_text	boolean	لا	false	إذا كان true، تُطبع value تحت الأعمدة.

مثال على الطلب

curl -X PATCH 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "value": "FORQR-2002",
  "height": 90
}'

DELETE/api/v1/barcodes/{id}

حذف باركود

الاسم	النوع	مطلوب	الوصف
id	integer	نعم	—

curl -X DELETE 'https://forqrcode.com/api/v1/barcodes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

أسماء المعلمات وأمثلة JSON بالإنجليزية. استبدل YOUR_API_KEY بمفتاح حسابك.