واجهة برمجة صور الباركود
رابط واحد، وصورة باركود واحدة — بلا مفتاح، وبلا حزمة تطوير، وبلا تسجيل. وجّه إليه وسم <img> أو رابطًا في Markdown أو معادلة في جدول بيانات فيعمل ببساطة.
مباشر — هذه الصورة تُنشئها فعلًا نقطة النهاية أدناه، الآن.
https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128المعاملات
| المعامل | الافتراضي | الحدود | الوصف |
|---|---|---|---|
| data | مطلوب | من ١ إلى ٢٥٦ حرفًا | القيمة المراد ترميزها. وأرقام التحقق (في EAN-13 وUPC-A وITF-14 وISBN وغيرها) تُكمَّل تلقائيًا — القاعدة نفسها المتّبعة في صانع الباركود على الموقع. ورمّز الأحرف الخاصة بترميز الروابط (فعلامة + الحرفية تُقرأ مسافةً، وهو العُرف القياسي في سلسلة الاستعلام الذي تتوقعه أصلًا كل جهة تستهلك رابطًا أو دالة IMAGE). |
| type | code128 | مُعرّف نوع مدعوم (انظر الجدول أدناه) | نوع الباركود المراد رسمه. |
| scale | 3 | من ١ إلى ٨ | مُضاعِف عرض الوحدة. والقيم الأعلى تنتج صورة أكبر وأعلى دقة — زِده للطباعة، وأنقصه للتضمين الصغير داخل النص. |
| fmt | png | png أو svg | صيغة الصورة المُعادة. وصيغة SVG تتحجّم إلى أي مقاس بلا فقد في الجودة، أما PNG فهي الخيار الافتراضي الأكثر أمانًا لجداول البيانات وأنظمة إدارة المحتوى التي لا تعرض SVG. |
| addon | لا شيء | خمسة أرقام بالضبط — مع النوع isbn فقط | ملحق سعر EAN-5، ولا يُطبَّق إلا مع type=isbn (وهو يطابق حقل ملحق سعر ISBN في أداة الإنشاء). ويُتجاهل مع كل نوع آخر. |
| text | الافتراضي حسب النوع | 0 أو 1 | هل تُرسم الأحرف التي يقرأها الإنسان تحت الأعمدة. فالقيمة text=0 تفرض الأعمدة وحدها، والقيمة text=1 تفرض إظهارها، وحذف المعامل يستخدم الإعداد الافتراضي للنوع نفسه (ظاهر في أغلب الأنواع، ومخفي في Data Matrix وQR). وأي قيمة أخرى تُعيد الخطأ 400. |
مقتطفات جاهزة للنسخ
<img src="https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128" alt="Barcode for SKU-12345" width="300" height="100" />=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= | الباركود | الفئة |
|---|---|---|
| code128 | Code 128 | General |
| code39 | Code 39 | General |
| ean13 | EAN-13 | Retail |
| ean8 | EAN-8 | Retail |
| upca | UPC-A | Retail |
| upce | UPC-E | Retail |
| itf14 | ITF-14 | Logistics |
| gs1-128 | GS1-128 | Logistics |
| datamatrix | Data Matrix | 2D |
| qrcode | QR Code | 2D |
| isbn | ISBN | Retail |
الأسئلة الشائعة
هل واجهة برمجة الباركود مجانية؟
GET /api/barcode مجاني وبلا حدود — بلا مفتاح واجهة، وبلا حساب، وبلا حد لعدد الطلبات. فهي نقطة نهاية عامة للصور، ووُضعت لتُربط مباشرةً من جدول بيانات أو نظام إدارة محتوى أو ملف README تمامًا كأي رابط صورة آخر.هل أستطيع استخدامها في جداول بيانات Google؟
=IMAGE("https://www.barcodesheets.com/api/barcode?data=YOUR-VALUE&type=code128") في خلية (أو أشِر إلى قيمة خلية أخرى في المعامل data=) فيُرسم الباركود هناك مباشرةً، ويتحدّث تلقائيًا إذا تغيّرت القيمة. ويدعم Excel 365 (المتصل بالسحابة) دالة =IMAGE() نفسها.هل هناك حد لعدد الطلبات؟
ما أنواع الباركود التي تدعمها واجهة البرمجة؟
type= نفسه المعروض في قائمة الأنواع أدناه وفي صفحة كل نوع (مثل صفحة /isbn للمُعرّف isbn).