توثيق API
الباركودات
إدارة الباركودات الخاصة بك وإعدادات تصديرها.
المصادقة
يجب أن يرسل كل طلب ترويسة Authorization مع رمز Bearer مطابق لمفتاح API الأدمن.
احصل على مفتاح API.
نقطة النهاية
GET https://rqrcode.com/api/barcodes/
مثال
curl --request GET \
--url 'https://rqrcode.com/api/barcodes/' \
--header 'Authorization: Bearer {api_key}'
المعاملات
| المعاملات | التفاصيل | الوصف |
|---|---|---|
| page |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
رقم الصفحة التي تريد الحصول على النتائج لها. الافتراضي هو 1. |
| results_per_page |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
عدد النتائج التي تريدها لكل صفحة. القيم المسموح بها هي: 10، 25، 50، 100، 250، 500، 1000. الافتراضي هو 25. |
مثال على الاستجابة
{
"data": [
{
"id": 1,
"type": "C32",
"name": "اسم المثال",
"value": "123456",
"barcode": "https://rqrcode.com/uploads/barcode/example.svg",
"settings": {
"foreground_color": "#000000",
"width_scale": 2,
"height": 50
},
"embedded_data": "123456",
"last_datetime": null,
"datetime": "2026-04-20 07:52:55"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://rqrcode.com/api/barcodes?page=1",
"last": "https://rqrcode.com/api/barcodes?page=1",
"next": null,
"prev": null,
"self": "https://rqrcode.com/api/barcodes?page=1"
}
}
نقطة النهاية
GET https://rqrcode.com/api/barcodes/{barcode_id}
مثال
curl --request GET \
--url 'https://rqrcode.com/api/barcodes/{barcode_id}' \
--header 'Authorization: Bearer {api_key}'
المعاملات
لا توجد معاملات إضافية.
مثال على الاستجابة
{
"data": {
"id": 1,
"type": "C32",
"name": "اسم المثال",
"value": "123456",
"barcode": "https://rqrcode.com/uploads/barcode/example.svg",
"settings": {
"foreground_color": "#000000",
"width_scale": 2,
"height": 50
},
"embedded_data": "123456",
"last_datetime": null,
"datetime": "2026-04-20 07:52:55"
}
}
نقطة النهاية
POST https://rqrcode.com/api/barcodes
مثال
curl --request POST \
--url 'https://rqrcode.com/api/barcodes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=نيويورك' \
--form 'type=C32' \
--form 'value=123456'
المعاملات
| المعاملات | التفاصيل | الوصف |
|---|---|---|
| project_id |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
— |
| name |
مطلوب
ui.admin.api_docs.common.types.نص
|
— |
| type |
مطلوب
ui.admin.api_docs.common.types.نص
|
القيم المسموح بها: 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 |
| is_bulk |
اختياري
ui.admin.api_docs.common.types.قيمة منطقية
|
— |
| value |
مطلوب
ui.admin.api_docs.common.types.نص
|
— |
| display_text |
اختياري
ui.admin.api_docs.common.types.قيمة منطقية
|
— |
| foreground_color |
اختياري
ui.admin.api_docs.common.types.نص
|
— |
| background_color |
اختياري
ui.admin.api_docs.common.types.نص
|
— |
| width_scale |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
1-10 |
| height |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
30-1000 |
مثال على الاستجابة
{
"data": {
"id": 1
}
}
نقطة النهاية
POST https://rqrcode.com/api/barcodes/{barcode_id}
مثال
curl --request POST \
--url 'https://rqrcode.com/api/barcodes/{barcode_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=لاس فيغاس' \
--form 'value=123456'
المعاملات
| المعاملات | التفاصيل | الوصف |
|---|---|---|
| project_id |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
— |
| name |
اختياري
ui.admin.api_docs.common.types.نص
|
— |
| type |
اختياري
ui.admin.api_docs.common.types.نص
|
القيم المسموح بها: 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 |
| value |
مطلوب
ui.admin.api_docs.common.types.نص
|
— |
| display_text |
اختياري
ui.admin.api_docs.common.types.قيمة منطقية
|
— |
| foreground_color |
اختياري
ui.admin.api_docs.common.types.نص
|
— |
| background_color |
اختياري
ui.admin.api_docs.common.types.نص
|
— |
| width_scale |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
1-10 |
| height |
اختياري
ui.admin.api_docs.common.types.عدد صحيح
|
30-1000 |
مثال على الاستجابة
{
"data": {
"id": 1
}
}
نقطة النهاية
DELETE https://rqrcode.com/api/barcodes/{barcode_id}
مثال
curl --request DELETE \
--url 'https://rqrcode.com/api/barcodes/{barcode_id}' \
--header 'Authorization: Bearer {api_key}'
المعاملات
لا توجد معاملات إضافية.
مثال على الاستجابة
هيئة استجابة 200 فارغة عند النجاح.