BarcodeSheets

واجهة برمجة صور الباركود

رابط واحد، وصورة باركود واحدة — بلا مفتاح، وبلا حزمة تطوير، وبلا تسجيل. وجّه إليه وسم <img> أو رابطًا في Markdown أو معادلة في جدول بيانات فيعمل ببساطة.

باركود تجريبي يُرمّز القيمة SKU-12345

مباشر — هذه الصورة تُنشئها فعلًا نقطة النهاية أدناه، الآن.

https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128

المعاملات

المعاملالافتراضيالحدودالوصف
dataمطلوبمن ١ إلى ٢٥٦ حرفًاالقيمة المراد ترميزها. وأرقام التحقق (في EAN-13 وUPC-A وITF-14 وISBN وغيرها) تُكمَّل تلقائيًا — القاعدة نفسها المتّبعة في صانع الباركود على الموقع. ورمّز الأحرف الخاصة بترميز الروابط (فعلامة + الحرفية تُقرأ مسافةً، وهو العُرف القياسي في سلسلة الاستعلام الذي تتوقعه أصلًا كل جهة تستهلك رابطًا أو دالة IMAGE).
typecode128مُعرّف نوع مدعوم (انظر الجدول أدناه)نوع الباركود المراد رسمه.
scale3من ١ إلى ٨مُضاعِف عرض الوحدة. والقيم الأعلى تنتج صورة أكبر وأعلى دقة — زِده للطباعة، وأنقصه للتضمين الصغير داخل النص.
fmtpngpng أو svgصيغة الصورة المُعادة. وصيغة SVG تتحجّم إلى أي مقاس بلا فقد في الجودة، أما PNG فهي الخيار الافتراضي الأكثر أمانًا لجداول البيانات وأنظمة إدارة المحتوى التي لا تعرض SVG.
addonلا شيءخمسة أرقام بالضبط — مع النوع isbn فقطملحق سعر EAN-5، ولا يُطبَّق إلا مع type=isbn (وهو يطابق حقل ملحق سعر ISBN في أداة الإنشاء). ويُتجاهل مع كل نوع آخر.
textالافتراضي حسب النوع0 أو 1هل تُرسم الأحرف التي يقرأها الإنسان تحت الأعمدة. فالقيمة text=0 تفرض الأعمدة وحدها، والقيمة text=1 تفرض إظهارها، وحذف المعامل يستخدم الإعداد الافتراضي للنوع نفسه (ظاهر في أغلب الأنواع، ومخفي في Data Matrix وQR). وأي قيمة أخرى تُعيد الخطأ 400.

مقتطفات جاهزة للنسخ

وسم <img> في HTML
<img src="https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128" alt="Barcode for SKU-12345" width="300" height="100" />
Markdown
![Barcode for SKU-12345](https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128)
دالة =IMAGE() في جداول بيانات Google وExcel 365
=IMAGE("https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128")

ماذا تفعل نقطة النهاية هذه

يأخذ الطلب GET /api/barcode معاملات البيانات والنوع والمقياس نفسها التي يستخدمها صانع الباركود على الموقع، ويعيد صورة باركود حقيقية مرسومة — بصيغة PNG افتراضيًا، أو SVG مع fmt=svg — بدل صفحة ويب. وجّه أي وسم <img> أو رابط صورة في Markdown أو معادلة =IMAGE() في جدول بيانات إلى الرابط فيظهر الباركود حيث يُضمَّن ذلك الرابط، بلا خطوة تنزيل ثم رفع بينهما. وتُكمَّل أرقام التحقق تلقائيًا لأنواع عائلة GTIN تمامًا كما في صانع الباركود — فقيمة data= من ١٢ رقمًا مع type=ean13 تصير في الصورة المُعادة رمز EAN-13 حقيقيًا قابلًا للقراءة من ١٣ رقمًا.

الاستخدام العادل — حدود سخية وبلا مفتاح

لا حساب ولا مفتاح واجهة ولا أي مصادقة إطلاقًا — فكل معامل تحتاجه موجود في الرابط نفسه. والحدود سخية عمدًا لا محتسَبة: حتى ٢٥٦ حرفًا في data=، ونطاق scale= من ١ إلى ٨. وكل استجابة ناجحة تحمل الرأس Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable، فيُخزَّن الرابط نفسه بالضبط سنة كاملة لدى المتصفحات وشبكات توصيل المحتوى معًا — فجدول بيانات بألف صف موجَّه إلى نقطة النهاية هذه لا يرسم كل باركود فريد إلا مرة واحدة. أما الإساءة الفعلية فشأن منصة الاستضافة، لا شيء يفرضه هذا المسار بنفسه. كما أن سياسة مشاركة الموارد بين المصادر مفتوحة تمامًا (Access-Control-Allow-Origin: * في كل استجابة، ناجحة كانت أو خاطئة)، فاستدعاء fetch() للرابط من JavaScript في موقع آخر — لرسمه على <canvas> أو تضمينه رابط بيانات، لا كوسم <img> عادي فحسب — يعمل من أي مصدر أيضًا.

أنواع الباركود المدعومة

type=الباركودالفئة
code128Code 128General
code39Code 39General
ean13EAN-13Retail
ean8EAN-8Retail
upcaUPC-ARetail
upceUPC-ERetail
itf14ITF-14Logistics
gs1-128GS1-128Logistics
datamatrixData Matrix2D
qrcodeQR Code2D
isbnISBNRetail

الأسئلة الشائعة

هل واجهة برمجة الباركود مجانية؟

نعم. الطلب GET /api/barcode مجاني وبلا حدود — بلا مفتاح واجهة، وبلا حساب، وبلا حد لعدد الطلبات. فهي نقطة نهاية عامة للصور، ووُضعت لتُربط مباشرةً من جدول بيانات أو نظام إدارة محتوى أو ملف README تمامًا كأي رابط صورة آخر.

هل أستطيع استخدامها في جداول بيانات Google؟

نعم — وهذه هي حالة الاستخدام الأساسية. ضع =IMAGE("https://www.barcodesheets.com/api/barcode?data=YOUR-VALUE&type=code128") في خلية (أو أشِر إلى قيمة خلية أخرى في المعامل data=) فيُرسم الباركود هناك مباشرةً، ويتحدّث تلقائيًا إذا تغيّرت القيمة. ويدعم Excel 365 (المتصل بالسحابة) دالة =IMAGE() نفسها.

هل هناك حد لعدد الطلبات؟

لا حد لكل مفتاح ولا لكل عنوان IP تفرضه نقطة النهاية نفسها — فالحدود هنا سخية عمدًا (حتى ٢٥٦ حرفًا من البيانات، ومقياس من ١ إلى ٨) لأنها مبنية للربط المباشر لا لمنتج واجهة برمجة محتسَب. وكل صورة ناجحة تُقدَّم برأس تخزين مؤقت غير قابل للتغيير مدته سنة، فجدول بيانات أو صفحة تطلب الباركود نفسه مرارًا لا ترسمه إلا مرة واحدة؛ أما الإساءة الفعلية فتُعالَج على مستوى منصة الاستضافة لا في هذا المسار.

ما أنواع الباركود التي تدعمها واجهة البرمجة؟

كل نوع يدعمه صانع الباركود في هذا الموقع — Code 128 وCode 39 وEAN-13 وEAN-8 وUPC-A وUPC-E وITF-14 وGS1-128 وData Matrix وQR Code وISBN — بالمُعرّف type= نفسه المعروض في قائمة الأنواع أدناه وفي صفحة كل نوع (مثل صفحة /isbn للمُعرّف isbn).